instar 1.3.1643 → 1.3.1645

package/dashboard/console/accounts.js

@@ -7,7 +7,7 @@
 //   repair / retry / cancel   POST /subscription-relogin/repair-cell       operator session
 
 import { buildAccountsPage, frameworkName } from './accounts-model.js';
-import { el, setKids, pageHead, sheet, closeSheet, story, details, note, cantTell, askPin, forgetOperatorSession } from './ui.js';
+import { el, setKids, pageHead, sheet, closeSheet, story, details, note, cantTell, askPin, forgetOperatorSession, firstPaint, arrivalScroll } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { verifiedDisplayName } from './display-identity.js';
 
@@ -22,7 +22,7 @@ async function postJson(path, body, headers = {}) {
 
 export async function renderAccounts(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.acct-list')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Capacity · Accounts' }), el('h1', { class: 'page-title skeleton', text: 'Loading accounts' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Capacity · Accounts' }), el('h1', { class: 'page-title skeleton', text: 'Loading accounts' })));
   const [pool, relogin, inUse, machines] = await Promise.all([get('/subscription-pool?scope=pool', 8000), get('/subscription-relogin?scope=pool', 8000), get('/subscription-pool/in-use'), get('/pool')]);
   const names = machines.ok && Array.isArray(machines.data && machines.data.machines) ? Object.fromEntries(machines.data.machines.map((m) => [m.machineId, m.nickname])) : {};
   const episodes = relogin.ok && Array.isArray(relogin.data && relogin.data.episodes) ? relogin.data.episodes : [];
@@ -66,7 +66,7 @@ export async function renderAccounts(main, ctx) {
     !relogin.ok ? note(`Couldn't read sign-in repairs: ${relogin.reason}.`) : null,
     needs, list, legacyLink());
   const want = new URLSearchParams((location.hash.split('?')[1] || '')).get('s');
-  if (want === 'needs' && needs) needs.scrollIntoView({ block: 'start' });
+  if (want === 'needs') arrivalScroll(needs);
 }
 
 function legacyLink() {

package/dashboard/console/agents.js

@@ -14,7 +14,7 @@
 import {
   buildAgentsPage, threadModel, inviteResultWords, pinResultWords, bearerResultWords, enableWords, bindRequest, bindResultWords, localTime,
 } from './agents-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, askPin } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, askPin, firstPaint } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { verifiedDisplayName, uniqueNamedChoices } from './display-identity.js';
 import { topicNameMap } from './topic-names.js';
@@ -48,7 +48,7 @@ async function send(path, body, method = 'POST') {
 }
 
 export async function renderAgents(main, ctx) {
-  if (!main.querySelector('.agents-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading other agents' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading other agents' })));
   const [health, pairingRes, invitesRes, peersRes, convRes, threadsRes, poolRes, topicsRes] = await Promise.all([
     read('/threadline/health'), read('/threadline/pairing'), read('/threadline/pairing/invites'),
     read('/threadline/peers/health?scope=pool', POOL_TIMEOUT_MS), read('/threadline/conversations?scope=mesh'), read('/threadline/observability/threads'), read('/pool'), read('/telegram/topics?scope=pool', POOL_TIMEOUT_MS),

package/dashboard/console/allowed.js

@@ -8,7 +8,7 @@ import {
   buildProfile, buildHistory, buildGuards, buildSuggestions, buildFeatures, flattenFeature, profileChanges,
   walkToEnabled, canTurnOff, canUndoOff, needsConsent, facts, applyText, refusalText, PROFILE_LABEL, PROFILE_SENTENCE, STATE_WORD,
 } from './allowed-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, actionButton, askPin, operatorSession, forgetOperatorSession } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, actionButton, askPin, operatorSession, forgetOperatorSession, firstPaint, arrivalScroll } from './ui.js';
 import { legacyHref } from './nav-model.js';
 
 const featureErrors = new Map(); // feature id → the server's last refusal, shown beside the row
@@ -40,7 +40,7 @@ const errWords = (r) => {
 
 export async function renderAllowed(main, ctx) {
   const { get, post } = ctx;
-  if (!main.querySelector('.allowed-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Settings · What I’m allowed to do' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Settings · What I’m allowed to do' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
   const [auto, hist, elev, guardsRes, featRes] = await Promise.all([
     get('/autonomy'), get('/autonomy/history'), get('/autonomy/elevation'), get('/guards?scope=pool', 8000), get('/features'),
   ]);
@@ -66,8 +66,7 @@ export async function renderAllowed(main, ctx) {
 
   const want = new URLSearchParams((location.hash.split('?')[1] || '')).get('s');
   if (want) {
-    const sec = main.querySelector(`#sec-${want}`);
-    if (sec) sec.scrollIntoView({ block: 'start' });
+    arrivalScroll(main.querySelector(`#sec-${want}`));
   }
 }
 

package/dashboard/console/console.js

@@ -30,7 +30,7 @@ import { renderSessions } from './sessions.js';
 import { renderMaturation, maturationTile } from './maturation-board.js';
 import { renderIdeas, ideasTile } from './ideas.js';
 import { paceCard } from './pace.js';
-import { sheetIsOpen, closeSheet, unlockCheck, machineIssue, MACHINES_PAGE } from './ui.js';
+import { sheetIsOpen, closeSheet, unlockCheck, machineIssue, MACHINES_PAGE, newArrival, refreshHeld } from './ui.js';
 
 const TOKEN_KEY = 'instar_token';      // shared with the legacy dashboard
 const THEME_KEY = 'instar_console_theme';
@@ -639,6 +639,7 @@ const NATIVE = {
 function route() {
   if (homeRun) { homeRun.active = false; for (const p of Object.values(homeRun.pending)) if (p && p !== true) clearTimeout(p); homeRun = null; }
   closeSheet();
+  newArrival();
   const path = (location.hash.replace(/^#\/?/, '') || 'home').split('?')[0];
   const id = path.split('/')[0];
   const group = GROUPS.find((g) => g.id === id);
@@ -647,9 +648,13 @@ function route() {
   if (refreshTimer) { clearInterval(refreshTimer); refreshTimer = null; }
   if (NATIVE[path]) {
     NATIVE[path](main, { get, post, getCommitments });
-    // Pages refresh in place every 30 s while visible, never over an open sheet.
+    // Pages refresh in place every 30 s while visible, never over an open sheet or an
+    // interaction in progress, and one at a time: a slow read cannot paint over a newer one.
+    let refreshing = false;
     refreshTimer = setInterval(() => {
-      if (document.visibilityState === 'visible' && !sheetIsOpen() && (location.hash.replace(/^#\/?/, '').split('?')[0]) === path) NATIVE[path](main, { get, post, getCommitments });
+      if (refreshing || document.visibilityState !== 'visible' || sheetIsOpen() || refreshHeld(main) || (location.hash.replace(/^#\/?/, '').split('?')[0]) !== path) return;
+      refreshing = true;
+      Promise.resolve().then(() => NATIVE[path](main, { get, post, getCommitments })).catch(() => { /* @silent-fallback-ok: a failed refresh keeps the page on screen; the next tick tries again */ }).finally(() => { refreshing = false; });
     }, REFRESH_MS);
   } else if (group) renderGroup(main, group); else renderHome(main);
   window.scrollTo(0, 0);

package/dashboard/console/costs.js

@@ -4,7 +4,7 @@
 // reaches the DOM through textContent; the model (costs-model.js) decides everything.
 
 import { buildCostsPage, WINDOWS, DEFAULT_WINDOW, GRAINS, windowParams, spendQuery, committedLine, basisWord, fmtTokens, fmtUsd, modelWord, doorWord } from './costs-model.js';
-import { el, setKids, pageHead, section, sheet, story, details, note, cantTell } from './ui.js';
+import { el, setKids, pageHead, section, sheet, story, details, note, cantTell, firstPaint } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { sessionLabel } from './home-model.js';
 
@@ -19,7 +19,7 @@ const view = { window: DEFAULT_WINDOW, grain: 'day' };
 
 export async function renderCosts(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.costs-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading what thinking costs' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading what thinking costs' })));
   const w = windowParams(view.window);
   const [spend, caps, status, metrics, insights, tokens, claude, codex, orphans, chains, sessions] = await Promise.all([
     get(`/routing-spend/summary?${spendQuery(view.grain, w.sinceHours)}`), get('/routing-spend/caps'), get('/routing-spend/enable-status'),

package/dashboard/console/development.js

@@ -13,7 +13,7 @@ import {
   buildShipping, buildPace, buildFeedback, developmentHeadline, stoppedLead, foldFromHash, maintainerMode, authorityCard, holdWords, verifyWords, rollbackWords,
   readinessAuthorityRequest, triageAuthorityRequest, commitRequest, authorityResultWords, commitResultWords, newDecisionRef, PACE_METRICS, DEV_TOOLS_KEY,
 } from './development-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, askPin } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, askPin, firstPaint, arrivalScroll } from './ui.js';
 import { legacyHref } from './nav-model.js';
 
 const EYEBROW = 'Work · Development';
@@ -93,7 +93,7 @@ export async function renderDevelopment(main, ctx) {
   // Each navigation gets a new <main>, so no page yet means someone just arrived: a `?s=` link wins over the
   // remembered fold then. A 30-second refresh keeps the page, so it never overrides what the operator opened or closed.
   if (!main.querySelector('.dev-page')) {
-    setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading development' })));
+    firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading development' })));
     const want = foldFromHash(location.hash);
     if (want) { view.open = want; view.scrollTo = want; }
   }
@@ -140,7 +140,7 @@ function paint() {
   if (view.scrollTo) {
     const sec = main.querySelector(`#sec-${view.scrollTo}`);
     view.scrollTo = null;
-    if (sec) sec.scrollIntoView({ block: 'start' });
+    arrivalScroll(sec);
   }
 }
 

package/dashboard/console/ideas.js

@@ -1,7 +1,7 @@
 // Ecosystem ideas page (docs/specs/ecosystem-idea-pipeline.md §9). Advice only: it builds nothing.
 // Every value is written with textContent via el(). Decisions go through the PIN plan and commit.
 
-import { el, pageHead, cantTell, askPin, note } from './ui.js';
+import { el, pageHead, cantTell, askPin, note, setKids } from './ui.js';
 import { BANDS, ideasInBand, headline, funnelLine, admissionLine, classWords, projectLine, planRequest } from './ideas-model.js';
 
 let probeResult = null;
@@ -50,7 +50,7 @@ export async function renderIdeas(main, api) {
   const refresh = () => renderIdeas(main, api);
   const r = await api.get('/ecosystem-ideas?scope=pool', 12_000);
   if (!r.ok) {
-    main.replaceChildren(r.reason === 'switched off on this agent'
+    setKids(main, r.reason === 'switched off on this agent'
       ? el('section', {}, el('div', { class: 'eyebrow', text: 'Ideas' }), el('h1', { text: 'The idea review is not switched on for this agent.' }))
       : cantTell(r.reason));
     return;
@@ -84,7 +84,7 @@ export async function renderIdeas(main, api) {
     parts.push(el('div', { class: 'need-card' }, el('span', { class: 'need-title', text: `Suggested: ${p.repo}` }), el('p', { class: 'need-sub', text: p.reason }), add, status));
   }
   if (s.lastTickError) parts.push(note(`The last round had a problem: ${s.lastTickError}`));
-  main.replaceChildren(el('div', { class: 'ideas-page' }, parts));
+  setKids(main, el('div', { class: 'ideas-page' }, parts));
 }
 
 export function ideasTile(get) {

package/dashboard/console/inside.js

@@ -16,7 +16,7 @@ import {
   CHIPS, KINDS, KIND_WORDS, COUNTERPARTIES, COUNTERPARTY_WORDS, STAGE_INFO, LOOKUP_KINDS, SCOPES, ADVISORY, CLAIM_KEYS, REVIEW_KEYS, CLAIMS_PAGE, WINDOW_STEP,
   setPeerNames,
 } from './inside-model.js';
-import { el, setKids, pageHead, sheet, closeSheet, story, details, note, cantTell } from './ui.js';
+import { el, setKids, pageHead, sheet, closeSheet, story, details, note, cantTell, firstPaint, arrivalScroll } from './ui.js';
 
 const EYEBROW = 'Settings · Under the hood';
 const SUBTITLE = 'Conversation history, recurring problems, checks on my claims.';
@@ -24,7 +24,6 @@ const SUBTITLE = 'Conversation history, recurring problems, checks on my claims.
 const view = { chip: 'all', kind: null, counterparty: null, limit: WINDOW_STEP, older: [], claimsLimit: CLAIMS_PAGE, open: new Set() };
 let lastProblems = null;
 let lookupNode = null;
-let scrolledFor = null;
 
 function bearer() { try { return localStorage.getItem('instar_token') || ''; } catch { return ''; } }
 /** A write that keeps the status and body (the revoke route needs the intent header). */
@@ -38,7 +37,7 @@ async function send(req) {
 
 export async function renderInside(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.inside-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
   const [recent, stats, sessions, pool, insights, week, all, claimsRes, reviewsRes, pairingRes, ...pages] = await Promise.all([
     get(recentUrl({ limit: view.limit, counterparty: view.counterparty })), get('/shared-state/stats'), get('/shared-state/sessions'), get('/pool'),
     get('/failures/insights?limit=50'), get('/failures/analysis?sinceDays=7'), get('/failures/analysis'),
@@ -65,14 +64,10 @@ export async function renderInside(main, ctx) {
     pageHead({ eyebrow: `${EYEBROW} · How I’m doing inside`, headline: h.text, tone: h.tone, sub: h.sub || SUBTITLE, facts: insideFacts({ activity, problems, claims, reviews }) }),
     el('div', { class: 'page-sections' }, sections)));
   const want = new URLSearchParams(location.hash.split('?')[1] || '').get('s');
-  if (want && scrolledFor !== want) { scrolledFor = want; const sec = main.querySelector(`#sec-${want}`); if (sec) { openFold(sec); sec.scrollIntoView({ block: 'start' }); } }
+  if (want) arrivalScroll(main.querySelector(`#sec-${want}`), { open: true });
 }
 
 // ── shared bits ───────────────────────────────────────────────────────────
-function openFold(sec) {
-  const head = sec.querySelector(':scope > button.list-head');
-  if (head && head.getAttribute('aria-expanded') === 'false') head.click();
-}
 /** A collapsible block whose open state survives refreshes. */
 function fold(id, title, count, body, { tone } = {}) {
   const isOpen = view.open.has(id);
@@ -291,5 +286,5 @@ function lookupBlock(get) {
 /** Test seam: forget the remembered view between tests. */
 export function _resetInsideState() {
   view.chip = 'all'; view.kind = null; view.counterparty = null; view.limit = WINDOW_STEP; view.older = []; view.claimsLimit = CLAIMS_PAGE; view.open = new Set();
-  lastProblems = null; lookupNode = null; scrolledFor = null;
+  lastProblems = null; lookupNode = null;
 }

package/dashboard/console/learned.js

@@ -9,7 +9,7 @@ import {
   buildPreferences, buildCorrections, buildConflicts, machineNames, learnedHeadline, learnedFacts,
   correctionsUrl, kindWords, confidenceWords, correctionStatusWords, ADVISORY_LINE,
 } from './learned-model.js';
-import { el, setKids, pageHead, section, sheet, story, details, note, cantTell } from './ui.js';
+import { el, setKids, pageHead, section, sheet, story, details, note, cantTell, firstPaint } from './ui.js';
 
 const PAGE = 20;
 // The last good preferences build, so a failed refresh shows it with its age (stale) instead of nothing.
@@ -21,7 +21,7 @@ const CORRECTION_KEYS = ['id', 'kind', 'status', 'occurrenceCount', 'detectedAt'
 
 export async function renderLearned(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.learned-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Settings · What I’ve learned about you' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Settings · What I’ve learned about you' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
   const [prefsRes, firstPage, conflictsRes, poolRes] = await Promise.all([
     get('/preferences/session-context'), get(correctionsUrl(null, PAGE)), get('/state/conflicts'), get('/pool'),
   ]);

package/dashboard/console/machines.js

@@ -3,14 +3,14 @@
 // the legacy tab until their PIN sheet is rebuilt (the plan's first cut).
 
 import { buildMachinesPage, ropesFor, healthOf, usageOf, machineCarePool } from './machines-model.js';
-import { el, setKids, pageHead, sheet, closeSheet, story, note, cantTell } from './ui.js';
+import { el, setKids, pageHead, sheet, closeSheet, story, note, cantTell, firstPaint } from './ui.js';
 import { legacyHref } from './nav-model.js';
 
 const STATE_DOT = { ok: 'dot live', attn: 'dot attn', bad: 'dot bad', stale: 'dot unknown', unknown: 'dot unknown' };
 
 export async function renderMachines(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.machine-cards')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Capacity · Machines' }), el('h1', { class: 'page-title skeleton', text: 'Loading machines' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Capacity · Machines' }), el('h1', { class: 'page-title skeleton', text: 'Loading machines' })));
   const [pool, health, guards, sessions, care] = await Promise.all([get('/pool'), get('/health'), get('/guards'), get('/sessions?scope=pool', 8000), get('/machine-maintenance?scope=pool', 8000)]);
   const live = sessions.ok && Array.isArray(sessions.data && sessions.data.sessions) ? sessions.data.sessions.filter((s) => s.status === 'running' || s.status === 'starting') : [];
   const byMachine = {};

package/dashboard/console/mandates.js

@@ -9,7 +9,7 @@ import {
   issueRequest, revokeRequest, grantRequest, approveRequest, denyRequest, resultWords,
   FLOOR_ACTIONS, GRANT_DURATIONS, AUTHORITIES_TEMPLATE, humanAction, defaultExpiryLocal,
 } from './mandates-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, askPin } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, askPin, firstPaint } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { verifiedDisplayName, uniqueNamedChoices } from './display-identity.js';
 
@@ -29,7 +29,7 @@ async function send(path, body) {
 
 export async function renderMandates(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.slips-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'People · Permission slips' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'People · Permission slips' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
   const [slipsRes, auditRes, approvalsRes, usersRes, healthRes, tlHealth, pairing] = await Promise.all([
     get('/mandate'), get(`/mandate/audit?limit=${AUDIT_LIMIT}`), get('/authorization-requests?status=pending'),
     get('/permissions/users'), get('/health'), get('/threadline/health'), get('/threadline/pairing/invites'),

package/dashboard/console/maturation-board.js

@@ -5,7 +5,7 @@
 // Layout, top to bottom: one answer sentence · a square per feature (the glance) ·
 // plain groups (Broken, Stuck, …) with one plain line per feature · details on tap.
 
-import { el, cantTell } from './ui.js';
+import { el, cantTell, setKids, firstPaint, arrivalScroll } from './ui.js';
 import { maturationPaceNode } from './pace.js';
 import {
   GROUPS, groupOf, groupCounts, headline, subline, parseState, stateQuery, openGroups,
@@ -21,16 +21,16 @@ let lastBoard = null;
  * @param nav    { read() → query string, write(query) } — where view state lives in the URL
  */
 export async function renderMaturation(main, api, nav = consoleNav()) {
-  if (!lastBoard) main.replaceChildren(el('p', { class: 'mb-loading', text: 'Reading every machine…' }));
+  if (!lastBoard) firstPaint(main, el('p', { class: 'mb-loading', text: 'Reading every machine…' }));
   const r = await api.get('/maturation/board?scope=pool', POOL_TIMEOUT_MS);
   if (!r.ok) {
     if (r.reason === 'switched off on this agent') {
-      main.replaceChildren(el('section', { class: 'mb-hero' },
+      setKids(main, el('section', { class: 'mb-hero' },
         el('div', { class: 'eyebrow', text: 'Feature maturation' }),
         el('h1', { class: 'mb-answer', text: 'The maturation board is not switched on for this agent.' })));
       return;
     }
-    if (!lastBoard) { main.replaceChildren(cantTell(r.reason)); return; }
+    if (!lastBoard) { setKids(main, cantTell(r.reason)); return; }
   } else {
     lastBoard = r.data;
   }
@@ -111,13 +111,12 @@ function draw(main, board, nav, pace = null) {
     return el('section', { class: 'mb-group' }, head, body);
   }).filter(Boolean);
 
-  main.replaceChildren(hero, glance, tools,
+  setKids(main, hero, glance, tools,
     sections.length ? el('div', { class: 'mb-groups' }, sections) : el('p', { class: 'mb-sub', text: 'Nothing matches.' }),
     sourcesNote(board));
 
   if (st.f) {
-    const target = main.querySelector('.mb-row[aria-expanded="true"]');
-    if (target && typeof target.scrollIntoView === 'function') target.scrollIntoView({ block: 'center' });
+    arrivalScroll(main.querySelector('.mb-row[aria-expanded="true"]'), { key: `row:${st.f}`, block: 'center' });
   }
 }
 

package/dashboard/console/messages.js

@@ -3,7 +3,7 @@
 // comes from /health and needs none.
 
 import { buildMessagesPage, displayModel, heldHeadline } from './messages-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, story, note, cantTell, askPin, operatorSession, forgetOperatorSession } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, story, note, cantTell, askPin, operatorSession, forgetOperatorSession, firstPaint } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { verifiedDisplayName, uniqueNamedChoices } from './display-identity.js';
 import { topicNameMap, isRealTopicName } from './topic-names.js';
@@ -25,7 +25,7 @@ async function opFetch(path, opts = {}) {
 export async function renderMessages(main, ctx) {
   const { get } = ctx;
   const first = !main.querySelector('.msg-page');
-  if (first) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'People · Messages to you' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
+  if (first) firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'People · Messages to you' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
   // A locked page is not re-polled against the PIN-gated routes every 30 s: only the
   // first render (and a render after an unlock) asks for the records.
   const locked = !first && !operatorSession() && main.querySelector('.need-card');

package/dashboard/console/plans.js

@@ -7,7 +7,7 @@
 import {
   buildPlansPage, roundsTrack, projectActions, resultWords, refusalWords, driftSentence, linkChips, stepList, blockerStory, reasonWord, statusWord, PROJECT_DETAIL_CAP, OPEN_STATUSES,
 } from './plans-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, sheetIsOpen, story, details, note, cantTell } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, sheetIsOpen, story, details, note, cantTell, firstPaint, arrivalScroll } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { topicNameMap } from './topic-names.js';
 import { topicLink } from './promises.js';
@@ -22,7 +22,7 @@ let last = null;                                // the last data read, repainted
 
 export async function renderPlans(main, ctx) {
   const { get, post } = ctx;
-  if (!main.querySelector('.plans-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading plans' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading plans' })));
   const [initiatives, digest, projects, blockers, floor, pool, topics] = await Promise.all([
     get('/initiatives'), get('/initiatives/digest'), get('/projects'), get('/blockers'), get('/autonomous/throughput-floor'), get('/pool'), get('/telegram/topics?scope=pool'),
   ]);
@@ -94,10 +94,7 @@ function paint() {
   let want = new URLSearchParams(path[1] || '').get('s');
   if (!want && /^work\/plans\/in-the-way/.test(path[0])) want = 'in-the-way';
   if (want) {
-    const sec = main.querySelector(`#sec-${want}`);
-    const head = sec && sec.querySelector('button.list-head[aria-expanded="false"]');
-    if (head) head.click();
-    if (sec) sec.scrollIntoView({ block: 'start' });
+    arrivalScroll(main.querySelector(`#sec-${want}`), { open: true });
   }
 }
 

package/dashboard/console/promises.js

@@ -4,7 +4,7 @@
 import { buildPromisesPage, storyOf, backstoryOf, updateQuestionOf, nextStepOf, actionsFor } from './promises-model.js';
 import { isInternalFollowUp } from './home-model.js';
 import { promiseActionLinks } from './promise-actions.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, sheetIsOpen, story, actionButton, note, cantTell } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, sheetIsOpen, story, actionButton, note, cantTell, firstPaint, arrivalScroll } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { verifiedDisplayName } from './display-identity.js';
 
@@ -19,7 +19,7 @@ export async function renderPromises(main, ctx) {
   if (main.dataset.promisesLoading === '1') return;
   main.dataset.promisesLoading = '1';
   const { get, post } = ctx;
-  setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Work · Promises' }), el('h1', { class: 'page-title skeleton', text: 'Loading promises' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'Work · Promises' }), el('h1', { class: 'page-title skeleton', text: 'Loading promises' })));
   const slow = setTimeout(() => {
     const title = main.querySelector('.page-title.skeleton');
     if (title) title.textContent = 'Still checking promises…';
@@ -67,10 +67,7 @@ export async function renderPromises(main, ctx) {
   // A fact links to its section: open it and scroll there.
   const want = new URLSearchParams((location.hash.split('?')[1] || '')).get('s');
   if (want) {
-    const sec = main.querySelector(`#sec-${want}`);
-    const head = sec && sec.querySelector('button.list-head[aria-expanded="false"]');
-    if (head) head.click();
-    if (sec) sec.scrollIntoView({ block: 'start' });
+    arrivalScroll(main.querySelector(`#sec-${want}`), { open: true });
   }
   // Home links to a specific request. Open its action sheet on arrival, so a
   // tap never strands the operator at the top of a long promise list.

package/dashboard/console/schedule.js

@@ -10,7 +10,7 @@
 import {
   buildSchedulePage, buildHistory, markText, storySentence, storyLines, jobActions, toggleConfirm, runStartWords, runFollowWords, saveRefusalWords, originWords, scheduleWords, ago, HISTORY_LIMIT, STRIP_LIMIT,
 } from './schedule-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, sheetIsOpen, story, details, note, noteLinked, cantTell } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, sheetIsOpen, story, details, note, noteLinked, cantTell, firstPaint, arrivalScroll } from './ui.js';
 import { legacyHref } from './nav-model.js';
 import { verifiedDisplayName } from './display-identity.js';
 
@@ -35,7 +35,7 @@ async function send(method, path, body) {
 
 export async function renderSchedule(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.schedule-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading the schedule' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: EYEBROW }), el('h1', { class: 'page-title skeleton', text: 'Loading the schedule' })));
   const [local, pool, machines, history, migration, reconcile] = await Promise.all([
     get('/jobs'), get('/jobs?scope=pool', 8000), get('/pool'), get('/jobs/history?limit=500'), get('/jobs/migration-status'), get('/jobs/reconcile'),
   ]);
@@ -82,10 +82,7 @@ function paint() {
   const params = new URLSearchParams(path[1] || '');
   const want = params.get('s');
   if (want) {
-    const sec = main.querySelector(`#sec-${want}`);
-    const head = sec && sec.querySelector('button.list-head[aria-expanded="false"]');
-    if (head) head.click();
-    if (sec) sec.scrollIntoView({ block: 'start' });
+    arrivalScroll(main.querySelector(`#sec-${want}`), { open: true });
   }
   const slug = params.get('job');
   if (slug && !sheetIsOpen()) {

package/dashboard/console/secrets.js

@@ -9,7 +9,7 @@ import {
   topicNameMap, conversationChoices, requestCard, requestBody, testRequestBody, resultWords, shareWords,
   leftWords, TTL_CHOICES,
 } from './secrets-model.js';
-import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell } from './ui.js';
+import { el, setKids, pageHead, section, sheet, closeSheet, story, details, note, cantTell, firstPaint } from './ui.js';
 import { legacyHref } from './nav-model.js';
 
 const RECORD_KEYS = ['token', 'topicId', 'createdAt', 'expiresAt'];
@@ -55,7 +55,7 @@ async function share(url, title, status) {
 
 export async function renderSecrets(main, ctx) {
   const { get } = ctx;
-  if (!main.querySelector('.secrets-page')) setKids(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'People · Passwords & keys' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
+  firstPaint(main, el('section', { class: 'hero page-hero' }, el('div', { class: 'eyebrow', text: 'People · Passwords & keys' }), el('h1', { class: 'page-title skeleton', text: 'Loading' })));
   const [pendingRes, ctxRes, syncRes, topicsRes, poolRes] = await Promise.all([
     get('/secrets/pending'), get('/self-knowledge/session-context?full=1'), get('/secrets/sync-status'), get('/telegram/topics?scope=pool'), get('/pool'),
   ]);

package/dashboard/console/ui.js

@@ -205,7 +205,110 @@ export function actionButton({ label, kind = 'primary', confirm, reason, run, do
 }
 
 /** replaceChildren that skips null/false (a bare null would render as the text "null"). */
-export function setKids(node, ...kids) { node.replaceChildren(...kids.flat(Infinity).filter((k) => k != null && k !== false)); }
+export function setKids(node, ...kids) {
+  const page = node.tagName === 'MAIN' && node.isConnected && node.childElementCount > 0 && !restoring ? capturePlace(node) : null;
+  if (node.tagName === 'MAIN') node.dataset.painted = '1';
+  node.replaceChildren(...kids.flat(Infinity).filter((k) => k != null && k !== false));
+  if (node.tagName !== 'MAIN' || restoring) return;
+  const drawn = foldStates(node);
+  if (page) restorePlace(node, page);
+  drawnFolds.set(node, drawn);
+}
+
+// ── A refresh keeps the operator's place (Dashboard UX Standard F12) ───────
+// Every page repaints by replacing what is in <main>. Replacing and restoring in
+// one task means the browser never paints the gap: no flash, no jump. Folds are
+// matched by what they say (numbers ignored, a count going from 3 to 4 is the same
+// fold), so this needs nothing from the page. Only a fold the operator moved away from
+// how the page last drew it is put back; a page that keeps its own fold state (and
+// repaints BECAUSE that state changed) is never fought.
+let restoring = false;
+const drawnFolds = new WeakMap(); // <main> → key → how the page itself last drew each fold
+const foldIsOpen = (n) => (n.tagName === 'DETAILS' ? n.open : n.getAttribute('aria-expanded') === 'true');
+function foldStates(root) {
+  const out = new Map();
+  for (const [n, key] of placeKeys(root)) if (n.tagName === 'DETAILS' || (n.tagName === 'BUTTON' && n.hasAttribute('aria-expanded'))) out.set(key, foldIsOpen(n));
+  return out;
+}
+function placeKeys(root) {
+  const seen = new Map();
+  const keys = new Map();
+  for (const n of root.querySelectorAll('*')) {
+    const tag = n.tagName;
+    const fold = tag === 'DETAILS' || (tag === 'BUTTON' && n.hasAttribute('aria-expanded'));
+    const scrolled = n.scrollTop > 0 || n.scrollLeft > 0;
+    const entry = tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || tag === 'BUTTON' || tag === 'A' || n.hasAttribute('tabindex');
+    if (!fold && !scrolled && !entry && n.classList.length === 0) continue;
+    const home = n.parentElement && n.parentElement.closest('[id]');
+    const label = (tag === 'DETAILS' ? (n.querySelector(':scope > summary') || n).textContent : fold || entry ? (n.getAttribute('aria-label') || n.textContent || n.getAttribute('name') || n.getAttribute('placeholder') || '') : n.className) || '';
+    const base = `${tag}|${home && home !== root ? home.id : ''}|${String(label).replace(/\d+/g, '#').trim().slice(0, 80)}`;
+    const nth = seen.get(base) || 0;
+    seen.set(base, nth + 1);
+    keys.set(n, `${base}|${nth}`);
+  }
+  return keys;
+}
+function capturePlace(root) {
+  const place = { x: window.scrollX, y: window.scrollY, folds: new Map(), scrolls: new Map(), focus: null };
+  const drawn = drawnFolds.get(root) || new Map();
+  for (const [n, key] of placeKeys(root)) {
+    if ((n.tagName === 'DETAILS' || (n.tagName === 'BUTTON' && n.hasAttribute('aria-expanded'))) && drawn.has(key) && drawn.get(key) !== foldIsOpen(n)) place.folds.set(key, foldIsOpen(n));
+    if (n.scrollTop > 0 || n.scrollLeft > 0) place.scrolls.set(key, [n.scrollLeft, n.scrollTop]);
+    if (n === document.activeElement) place.focus = key;
+  }
+  return place;
+}
+function restorePlace(root, place) {
+  restoring = true;
+  try {
+    for (const [n, key] of placeKeys(root)) {
+      if (!place.folds.has(key) || !n.isConnected) continue;
+      const was = place.folds.get(key);
+      if (foldIsOpen(n) === was) continue;
+      if (n.tagName === 'DETAILS') n.open = was;
+      else n.click();
+    }
+    // Fold changes above can add height; positions are restored last, against the final layout.
+    for (const [n, key] of placeKeys(root)) {
+      const at = place.scrolls.get(key);
+      if (at) { n.scrollLeft = at[0]; n.scrollTop = at[1]; }
+      if (place.focus === key && typeof n.focus === 'function') n.focus({ preventScroll: true });
+    }
+    if (window.scrollX !== place.x || window.scrollY !== place.y) window.scrollTo(place.x, place.y);
+  } finally { restoring = false; }
+}
+
+/** The loading placeholder: only ever shown before a page's first real paint, never over real content. */
+export function firstPaint(main, ...kids) {
+  if (main.dataset.painted) return;
+  main.replaceChildren(...kids.flat(Infinity).filter((k) => k != null && k !== false));
+}
+
+let arrived = new Set();
+/** A new page or link arrived (console route()): its deep-link scroll may run again. */
+export function newArrival() { arrived = new Set(); }
+/** The one way to scroll to a deep-linked section: once per arrival, per key, never on a repaint. */
+export function arrivalScroll(node, { key = 'page', open = false, block = 'start' } = {}) {
+  if (!node || arrived.has(key)) return false;
+  arrived.add(key);
+  if (open) { const head = node.querySelector('button.list-head[aria-expanded="false"]'); if (head) head.click(); }
+  if (typeof node.scrollIntoView === 'function') node.scrollIntoView({ block });
+  return true;
+}
+
+/** F9 at the shell: is the operator in the middle of something a repaint would destroy? */
+export function refreshHeld(root) {
+  if (!root) return false;
+  if (root.querySelector('[data-interaction-open]')) return true;
+  const a = document.activeElement;
+  if (a && root.contains(a) && (a.tagName === 'TEXTAREA' || a.tagName === 'SELECT' || a.isContentEditable || (a.tagName === 'INPUT' && !/^(button|checkbox|radio|submit|reset|range|color|file)$/.test(a.type)))) return true;
+  for (const f of root.querySelectorAll('input, textarea')) {
+    if (/^(button|checkbox|radio|submit|reset|range|color|file|hidden)$/.test(f.type || '')) continue;
+    if (f.value !== f.defaultValue) return true;
+  }
+  const sel = typeof window.getSelection === 'function' ? window.getSelection() : null;
+  return Boolean(sel && !sel.isCollapsed && sel.anchorNode && root.contains(sel.anchorNode));
+}
 
 // ── PIN sheet (00-patterns.md §4: one look, per-action adapters) ───────────
 // adapter 'session': POST /dashboard/unlock → operator-session token, held in page

package/dashboard/index.html

@@ -10467,9 +10467,11 @@
           apiFetch('/shared-state/stats').catch(() => null),
         ]);
         const tbody = document.getElementById('ibEntriesTbody');
+        // A read missed by a background refresh keeps the rows on screen (Dashboard UX F12).
         if (!recentRes || !recentRes.entries) {
-          tbody.innerHTML = '<tr><td colspan="7" style="padding:14px;color:var(--text-dim);text-align:center">Integrated-Being disabled or unavailable</td></tr>';
+          if (!tbody.dataset.ibRows) tbody.innerHTML = '<tr><td colspan="7" style="padding:14px;color:var(--text-dim);text-align:center">Integrated-Being disabled or unavailable</td></tr>';
         } else {
+          tbody.dataset.ibRows = '1';
           let entries = recentRes.entries;
           if (kind) entries = entries.filter(e => e.kind === kind);
           if (entries.length === 0) {

package/dist/data/standards-guard-index.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "generatedFrom": "source-tree",
   "registrySha256": "e9eb5bb7f56ce6f81c5f80210c1ec7999d4b8c7d2ff1ab5cfd97a269172ce2ac",
-  "packageVersion": "1.3.1643",
+  "packageVersion": "1.3.1645",
   "guards": [
     {
       "ref": "docs/audits/phase-b/f10-triage.md",

package/dist/data/standards-guard-index.meta.json

@@ -1,5 +1,5 @@
 {
-  "sha256": "7b7c5c131b95619879efffeefa2814a65af619c1ae31a4efd1622e8e16245651",
+  "sha256": "0acd00d1676c2247df6020ca0a532c139bd5ad6020cc63f78ef676773d8c1e12",
   "registrySha256": "e9eb5bb7f56ce6f81c5f80210c1ec7999d4b8c7d2ff1ab5cfd97a269172ce2ac",
-  "packageVersion": "1.3.1643"
+  "packageVersion": "1.3.1645"
 }