instar 1.3.1643 → 1.3.1644

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.1644",
   "guards": [
     {
       "ref": "docs/audits/phase-b/f10-triage.md",

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

@@ -1,5 +1,5 @@
 {
-  "sha256": "7b7c5c131b95619879efffeefa2814a65af619c1ae31a4efd1622e8e16245651",
+  "sha256": "d838f2be89c7527b0f0864e96d4caa6b96c98d1e6a0abde421d0ef686a3c2c5f",
   "registrySha256": "e9eb5bb7f56ce6f81c5f80210c1ec7999d4b8c7d2ff1ab5cfd97a269172ce2ac",
-  "packageVersion": "1.3.1643"
+  "packageVersion": "1.3.1644"
 }

package/dist/data/standards-registry.meta.json

@@ -2,5 +2,5 @@
   "sha256": "e9eb5bb7f56ce6f81c5f80210c1ec7999d4b8c7d2ff1ab5cfd97a269172ce2ac",
   "articleCount": 93,
   "generatedFrom": "docs/STANDARDS-REGISTRY.md",
-  "packageVersion": "1.3.1643"
+  "packageVersion": "1.3.1644"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.1643",
+  "version": "1.3.1644",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-11-04T02:44:31.654Z",
-  "instarVersion": "1.3.1643",
+  "generatedAt": "2026-11-04T03:09:47.613Z",
+  "instarVersion": "1.3.1644",
   "entryCount": 206,
   "entries": {
     "hook:session-start": {

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

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

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

@@ -1,5 +1,5 @@
 {
-  "sha256": "7b7c5c131b95619879efffeefa2814a65af619c1ae31a4efd1622e8e16245651",
+  "sha256": "d838f2be89c7527b0f0864e96d4caa6b96c98d1e6a0abde421d0ef686a3c2c5f",
   "registrySha256": "e9eb5bb7f56ce6f81c5f80210c1ec7999d4b8c7d2ff1ab5cfd97a269172ce2ac",
-  "packageVersion": "1.3.1643"
+  "packageVersion": "1.3.1644"
 }

package/src/data/standards-registry.meta.json

@@ -2,5 +2,5 @@
   "sha256": "e9eb5bb7f56ce6f81c5f80210c1ec7999d4b8c7d2ff1ab5cfd97a269172ce2ac",
   "articleCount": 93,
   "generatedFrom": "docs/STANDARDS-REGISTRY.md",
-  "packageVersion": "1.3.1643"
+  "packageVersion": "1.3.1644"
 }

package/upgrades/1.3.1644.md

@@ -0,0 +1,20 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+The console's 30-second refresh no longer moves the page. The shared repaint step in `dashboard/console/ui.js` now keeps the scroll position, any section the operator opened or closed, inner scroll positions and focus, restoring them before the browser draws. A link to a section scrolls once per arrival. A loading placeholder only shows before a page's first real content, so Promises and any page showing an error no longer blank themselves on refresh. The refresh also waits while a field is focused or holds typed text, or text is selected, and two refreshes can no longer overlap. In the legacy dashboard, a missed Integrated-Being read no longer blanks the table.
+
+## What to Tell Your User
+
+The dashboard no longer jumps back up the page or closes what you opened when it refreshes. Your place stays put and only the numbers change.
+
+## Summary of New Capabilities
+
+- Dashboard UX floor F12: a refresh keeps the operator's place, enforced by a test over every console page.
+
+## Evidence
+
+Measured in a real browser at 1280x728 against this agent's live data, before and after, on all 23 console routes and all 30 legacy tabs. Before: Permission slips 1795 to 169, Passwords and keys 698 to 165, Under the hood 4640 to 1785, Maturation 2930 to 483, Plans (in the way) 4451 to 1559, Costs 1161 to 959, Allowed 2937 to 2827, Machines 98 to 0, Promises 60 to 0 with a blank. After: all of them hold position with every fold still open. On the real 30-second timer, Development with a section link moved 339 to 419 before and held at 491 after. Legacy tabs showed no scroll movement; only Integrated-Being lost content on a poll, and that is fixed. `tests/unit/dashboard-refresh-keeps-place.test.ts` fails when a page is reverted to a placeholder or a raw scroll (checked by mutation).

package/upgrades/side-effects/console-refresh-keeps-place.eli16.md

@@ -0,0 +1,13 @@
+# A dashboard refresh no longer moves the page
+
+**What this changes, in plain words.** Every console page rebuilds itself every 30 seconds to show fresh data. Rebuilding threw away things the person looking at the page had set up. Sections they had opened snapped shut, which made the page shorter, which pulled them up the page. A link to a section scrolled to it again on every refresh, which is the jump the operator reported on the Development page. One page (Promises) blanked itself to a loading message every time, and pages showing an error did the same.
+
+Now the shared repaint step notes where the person is (scroll position, open sections, inner scroll positions, which control has focus), rebuilds, and puts all of it back before the browser draws anything. A person watching sees the numbers change and nothing else. A link scrolls once when you arrive. A loading placeholder only ever appears before the first real content. And a refresh waits while someone is typing or has text selected.
+
+**How it works without touching each page's logic.** Pages already called one shared function to fill the page, so the place-keeping lives there. Sections are matched by what they say, with numbers ignored, so "3 jobs" becoming "4 jobs" is still the same section. Pages that remember their own open sections simply already agree, and nothing is clicked.
+
+**What keeps it from coming back.** A test finds every registered console page, renders each twice the way the real refresh does, and fails if one shows a placeholder or scrolls. It also fails if a page repaints or scrolls around the shared helpers. It carries a count of pages, so if it stops finding them it fails loudly, and it proves on deliberately bad pages that it catches each fault.
+
+**What did not change.** No server route, no stored setting, no change to what any page shows or what any button does. Only browser files changed.
+
+**If it is wrong.** Revert the commit. There is no stored state or migration. The likely failure is a section reopening that should have stayed shut, or a refresh skipped while a field holds typed text, and neither loses anything.

package/upgrades/side-effects/console-refresh-keeps-place.md

@@ -0,0 +1,78 @@
+# Side-Effects Review — A dashboard refresh keeps the operator's place
+
+**Version / slug:** `console-refresh-keeps-place`
+**Date:** `2026-11-03`
+**Author:** `Echo`
+**Second-pass reviewer:** `not required`
+
+## Summary of the change
+
+Tier 1: browser-only files, 20 existing files plus a new test, half of it tests; one review round. `dashboard/console/ui.js` gains the place-keeping in `setKids`, plus `firstPaint`, `arrivalScroll`, `newArrival` and `refreshHeld`. `console.js` route() opens an arrival and holds or serializes the refresh tick. Fourteen pages swap their skeleton guard for `firstPaint`, and seven swap a raw scroll for `arrivalScroll`. `ideas.js` and `maturation-board.js` stop bypassing `setKids`. Legacy `index.html` keeps Integrated-Being rows on a missed read. A first version restored every fold and undid tab taps on Development; the existing Development test caught it, and now only folds the operator moved away from how the page drew them are restored.
+
+## Decision-point inventory
+
+One small decision: `refreshHeld` skips a background repaint while a focused or typed field, an `data-interaction-open` marker, or selected text exists on the page. It constrains only the page's own repaint, not information flow, and the next tick tries again.
+
+---
+
+## 1. Over-block
+
+A field holding typed text that the operator walked away from holds that page's refresh until it is cleared or they navigate. The page then shows older numbers, with no indicator. Accepted: F9 already chooses keeping typed text over fresh data, and a pre-filled field (value equal to its default) does not hold. Selected text holds the same way.
+
+## 2. Under-block
+
+A fold whose wording changes beyond numbers loses its match and returns to its default. A page that shrinks for real still moves the viewport (Home moved 1158 to 1119 when a row above went away), which is correct. A failed read on a page still replaces content with its "can't tell" line, without a jump above what the shorter page allows.
+
+## 3. Level-of-abstraction fit
+
+It belongs in `setKids`, the one call nearly every page already uses to fill `<main>`, so pages need no state of their own. Only `<main>` carries the place; nested repaints are plain replaces so a sub-part does not fight its page.
+
+## 4. Signal vs authority compliance
+
+Reference: `docs/signal-vs-authority.md`. Display behavior only, with no authority over messages, sessions or actions. The floor test is a CI check on source and rendered pages.
+
+## 4b. Judgment-point check (Judgment Within Floors standard)
+
+No competing-signals decision point. `refreshHeld` is an F9 floor over directly observed DOM state, not a judgment between live signals.
+
+## 5. Interactions
+
+- PR 2680 edits the same Development lines and drops the repeated scroll; this PR is rebased on it after it lands and replaces that site with `arrivalScroll`. Its `foldFromHash` stays.
+- A restored `button[aria-expanded]` fold is re-opened through its own click handler, so page state and lazy reads stay right. A lazy fold re-reads on each repaint, which is what an open fold on a refreshed page should do.
+- The Sessions and Files pages keep their own early returns and only repaint their list halves, so they are unaffected.
+- The shared Maturation view also runs on the standalone page, whose `<main>` is covered the same way.
+
+## 6. External surfaces
+
+Console and legacy dashboard behavior only. No route, message, config or stored state changes.
+
+## 6b. Operator-surface quality (Operator-Surface Quality standard)
+
+1. **Leads with the primary action?** Unchanged order; this keeps the operator where they are and never scrolls them away from an action. The first-screen rule is the next PR.
+2. **Zero raw internals as primary content?** No content changes.
+3. **Destructive actions de-emphasized?** No control changes.
+4. **Plain language + phone width?** No wording changes. The refresh was run at 390x844 on Permission slips and held position.
+
+## 7. Multi-machine posture (Cross-Machine Coherence)
+
+Machine-local by design: per-browser view state in page memory. Nothing to replicate.
+
+## 8. Rollback cost
+
+Revert the commit and release. Browser files only, with no state or migration.
+
+## Conclusion
+
+Clear to ship. The riskiest part, fold restore fighting page-owned state, was found by an existing test and is pinned by a new one.
+
+## Second-pass review (if required)
+
+Not required: no messaging, session lifecycle, gate or sentinel surface.
+
+## Evidence pointers
+
+`tests/unit/dashboard-refresh-keeps-place.test.ts` with a mutation check (a raw skeleton and a raw scroll each fail it). Browser before and after numbers are in `upgrades/next/console-refresh-keeps-place.md`. The dashboard PIN was never read or used; the browser used the agent's bearer token.
+
+## Class-Closure Declaration (display-only mirror)
+
+No agent-authored-artifact defect — not applicable.