runlist 0.96.0 → 0.97.0

package/assets/app/app.mjs

@@ -19,10 +19,10 @@ import { escapeHtml as esc, splitSource, editedSource, markdownHtml, lineDiff, d
 const $ = id => document.getElementById(id);
 const state = { doc:null, base:null, body:'', csrf:null, mode:'read', dirty:false, draft:null, recovery:null, conflict:null, pending:null, lastSave:null, busy:false, plans:[] };
 const clientId = sessionStorage.runlistClientId ||= crypto.randomUUID();
-let checkoutKey = '', draftTimer, persistence = Promise.resolve();
+let checkoutKey = '', draftTimer, persistence = Promise.resolve(), noticeError = false;
 let editorPath;
 const blockEditor = new BlockEditor($('block-editor'),{onChange:body=>bodyChanged(body),resolveLink:linked});
-const navigation = editorNavigation({state,editor:blockEditor,checkout:()=>checkoutKey,$,view,notice});
+const navigation = editorNavigation({state,editor:blockEditor,$,view,notice});
 templateEditor({api,$,checkout:()=>checkoutKey,notice});
 const library = libraryNavigation({state,$,api,open,showLibrary,checkout:()=>checkoutKey,notice});
 const settings=appSettings({$,api,checkout:()=>checkoutKey,library,notice});
@@ -30,7 +30,7 @@ const lifecycle=documentLifecycle({state,$,api,checkout:()=>checkoutKey,open,lib
 const yardstick=documentYardstick({state,$,api,checkout:()=>checkoutKey,open,library,notice});
 const filing=filingNavigation({state,$,api,open,showLibrary,checkout:()=>checkoutKey,notice});
 const records = recordNavigation({state,$,api,open,showLibrary,checkout:()=>checkoutKey,preferences:()=>settings.read(),notice,create:template=>creation.show({template})});
-const changes=gitChanges({state,$,api,open,showLibrary,checkout:()=>checkoutKey,notice,returnToDraft:()=>{view(state.doc.editable?'edit':'read');const url=new URL(location.href);url.searchParams.delete('view');url.searchParams.set('path',state.doc.path);history.replaceState(null,'',url);}});
+const changes=gitChanges({state,$,api,open,showLibrary,checkout:()=>checkoutKey,notice,returnToDraft:()=>{view(state.doc.editable?'edit':'read',{focus:true});const url=new URL(location.href);url.searchParams.delete('view');url.searchParams.set('path',state.doc.path);history.replaceState(null,'',url);}});
 const commits=gitCommit({$,api,checkout:()=>checkoutKey,selection:changes.selectedPaths,changed:()=>changes.invalidate(),notice});
 $('changes-commit').onclick=()=>{if(!$('changes-commit').disabled)return commits.show().catch(error=>notice(error.message,true));};
 const views = documentViews({$,view});
@@ -49,7 +49,8 @@ const quick=quickNavigation({$,api,state,library,open,jump:section=>navigation.j
   {title:'Templates',run:()=>$('open-templates').click()},{title:'Settings',run:()=>$('open-settings').click()},
   ...(library.savedViews?.()??[]).map(v=>({title:`View: ${v.name}`,detail:'Saved library filters',run:()=>library.applyView(v.id)})),
 ]});
-function notice(message, error = false) { $('notice').textContent = message; $('notice').classList.toggle('error', error); }
+let noticeTimer;
+function notice(message = '', error = false, {persistent=false} = {}) { clearTimeout(noticeTimer); $('notice').textContent = message; $('notice').hidden = !message; $('notice').classList.toggle('error', error); noticeError = error; if(message&&!error&&!persistent)noticeTimer=setTimeout(()=>notice(),3200); }
 async function api(route,body) {const result=await request(route,body,state.csrf);if(body!==undefined&&['save','undo','create/commit','lifecycle/commit','yardstick/commit','native/action','flags/triage'].includes(route)){changes.invalidate();filing.invalidate();}return result;}
 function guarded(fn) { return async () => { try { await fn(); } catch (error) { notice(error.message, true); } }; }
 function key(path = state.doc?.path) { return `runlist:recovery:${checkoutKey}:${encodeURIComponent(path)}:${clientId}`; }
@@ -83,22 +84,29 @@ function updateDirty() {
   state.dirty = candidate() !== state.base.source;
   const rows = lineDiff(state.base.source, candidate()), adds = rows.filter(r => r.kind === 'add').length, removes = rows.filter(r => r.kind === 'remove').length;
   $('change-count').textContent = state.dirty ? `${adds + removes}` : '';
-  $('review-summary').textContent = `${adds} added ${adds === 1 ? 'line' : 'lines'} · ${removes} removed ${removes === 1 ? 'line' : 'lines'} · ${state.doc.path}`;
+  $('review-summary').textContent = `${adds} added ${adds === 1 ? 'line' : 'lines'} · ${removes} removed ${removes === 1 ? 'line' : 'lines'}`;
   const claimed = state.doc.claim?.state === 'owned' || state.doc.claim?.corrupt;
   $('save').disabled = !state.dirty || !state.doc.editable || claimed || !!state.conflict || state.busy;
   $('edit').disabled = !state.doc.editable || state.busy;
+  $('edit').textContent = state.dirty || state.pending ? 'Review changes' : 'Edit document';
+  $('edit').hidden = state.mode === 'edit' || state.mode === 'review';
+  $('document-edit-actions').hidden = !state.dirty && !state.pending;
   $('tab-edit').disabled = !state.doc.editable || state.busy;
+  $('tab-review').disabled = (!state.dirty && !state.pending) || state.busy;
+  $('tab-review').hidden = !state.dirty && !state.pending;
   $('undo').disabled = !state.lastSave || state.dirty || claimed || state.busy;
   $('body-editor').readOnly = !!state.pending;
   blockEditor.setReadOnly(!!state.pending || !state.doc.editable);
-  $('toggle-markdown').disabled = !!state.pending;
+  $('toggle-markdown').disabled = !!state.pending || !state.doc.editable || state.busy;
   $('pending-note').hidden = !state.pending;
   stages.update(candidate());
   yardstick.update();
   $('save').textContent = state.pending ? state.pending.kind === 'undo' ? 'Retry undo' : 'Retry save' : 'Save changes';
 }
-function view(mode) {
+function view(mode, {focus=false} = {}) {
   if (!state.doc) return;
+  if(mode==='review'&&!state.pending&&candidate()===state.base.source)mode=state.mode==='edit'?'edit':'read';
+  records.beforeLeave?.();
   state.mode = mode;
   $('records-home').hidden=true;records.deactivate();changes.deactivate();filing.deactivate();
   $('workspace').classList.remove('library-start');$('empty').hidden=true;$('document').hidden=false;
@@ -109,10 +117,11 @@ function view(mode) {
   $('full-source').textContent = state.doc.source;
   $('diff').innerHTML = diffHtml(state.base.source, source);
   updateDirty();
-  if (mode === 'read' && state.dirty) notice('Previewing your draft. It has not been saved to the file.');
+  if (!noticeError) notice();
   if (mode === 'edit' && (editorPath !== state.doc.path || blockEditor.source() !== state.body)) { blockEditor.set(state.body,{readOnly:!!state.pending || !state.doc.editable}); editorPath=state.doc.path; }
   if (mode !== 'edit') blockEditor.hideTools();
   navigation.update();library.render();
+  if (focus) views.focus(mode);
 }
 function renderList() { library.render(); }
 
@@ -124,7 +133,7 @@ function renderDocumentSummary() {
 function renderEvidence() {
   const doc = state.doc;
   renderConnections();
-  $('file-info').innerHTML = `<dl><dt>Source file</dt><dd>${esc(doc.path)}</dd><dt>Revision</dt><dd><code>${esc(doc.revision.slice(0,23))}…</code></dd><dt>Actor</dt><dd>${esc($('identity').textContent)}</dd></dl><p class="muted">Source is the record. Save changes the file; derived views read it again.</p>`;
+  $('file-info').innerHTML = `<dl><dt>Source file</dt><dd>${esc(doc.path)}</dd><dt>Revision</dt><dd><code>${esc(doc.revision.slice(0,23))}…</code></dd><dt>Actor</dt><dd>${esc($('identity').textContent)}</dd></dl>`;
   $('flags').innerHTML = doc.flags.length ? doc.flags.map(flag => `<section class="flag"><span class="flag-tag">${esc(flag.id)} · ${esc(flag.severity)} · ${esc(flag.state)}</span><h3>${esc(flag.text)}</h3><h4>ORIGINAL OBSERVATION</h4><small>${esc(flag.original.file)}${flag.original.line ? `:${flag.original.line}` : ''}<br>${esc(flag.original.at ?? '')}</small><pre>${esc(flag.original.quote || 'File-level observation; no original quote was recorded.')}</pre><small>${esc(flag.original.revisionReason)}</small><h4>CURRENT LOCATION · ${esc(flag.current.status.toUpperCase())}</h4><pre class="current-quote">${esc(flag.current.quote ?? 'Current evidence is unavailable or ambiguous.')}</pre><small>${flag.current.line ? `Line ${flag.current.line} · ` : ''}${esc(flag.current.revision?.slice(0,23) ?? 'No current revision')}<br>Original evidence is retained.</small></section>`).join('') : '<p class="muted">No related flags recorded for this document.</p>';
 }
 function renderConnections() {
@@ -136,10 +145,11 @@ function renderConnections() {
 }
 async function open(path,selection={}) {
   if (state.busy) throw new Error('Wait for the current operation before switching plans.');
+  records.beforeLeave?.();
   await yardstick.beforeLeave();
   clearTimeout(draftTimer);
   if (state.doc && (state.dirty || state.pending)) { storeLocal(); await persistDraft(); if(!state.recoveryStored)throw new Error('Preserve your current draft before switching documents.'); }
-  notice('Opening document…');
+  notice();
   path=await lifecycle.resolveInitial(path);
   path=await yardstick.resolveInitial(path);
   const doc = await api(`document?path=${encodeURIComponent(path)}`);
@@ -158,13 +168,13 @@ async function open(path,selection={}) {
   if (recovery?.lastSave) state.lastSave = recovery.lastSave;
   const recoverable = recovery && (recovery.source !== recovery.baseSource || recovery.pending);
   $('recovery').hidden = !recoverable;
-  $('recovery-label').textContent = recoverable ? 'A locally preserved draft is available. Recover it to review changes; the Markdown file is unchanged.' : '';
-  $('draft-status').textContent = recoverable ? 'Draft available' : 'Saved source';
+  $('recovery-label').textContent = recoverable ? 'Unsaved draft available.' : '';
+  $('draft-status').textContent = ''; $('draft-status').title = '';
   $('claim').hidden = !(doc.claim?.corrupt || doc.claim?.state === 'owned' || !doc.editable);
   $('claim').textContent = doc.claim?.corrupt ? 'Ownership is corrupt. Repair it through the CLI before saving.' : doc.claim?.state === 'owned' ? `Owned by session ${doc.claim.sessionId}. You can keep a draft; coordinate or release the claim through the CLI before saving.` : !doc.editable ? 'This source is read only. Its format or metadata needs repair before saving.' : '';
   $('conflict').hidden = true; $('operation-repair').hidden = true; $('empty').hidden = true; $('document').hidden = false;$('workspace').classList.remove('library-start');
   $('doc-title').textContent = doc.title; $('doc-path').textContent = doc.path; $('doc-status').textContent = doc.status ?? '';
-  $('body-editor').value = state.body; $('markdown-fallback').hidden=true; $('block-editor').hidden=false; $('toggle-markdown').textContent='Edit Markdown'; $('toggle-markdown').setAttribute('aria-expanded','false'); renderList(); renderEvidence(); view(doc.editable?'edit':'read');
+  $('body-editor').value = state.body; $('markdown-fallback').hidden=true; $('block-editor').hidden=false; $('toggle-markdown').textContent='Edit Markdown'; $('toggle-markdown').setAttribute('aria-expanded','false'); renderList(); renderEvidence(); view('read');
   const url = new URL(location.href); url.searchParams.delete('ref');url.searchParams.delete('from');url.searchParams.delete('view');url.searchParams.delete('record');url.searchParams.set('path',doc.path); history.replaceState(null,'',url);
   library.opened();
   await yardstick.opened();
@@ -178,7 +188,7 @@ async function open(path,selection={}) {
       else sourceNotice='The recorded line is unavailable. Current hub source is open.';
     }
   }
-  $('sidebar').classList.remove('open');$('toggle-plans').setAttribute('aria-expanded','false');if(!selection.line)window.scrollTo(0,0); notice(sourceNotice??(doc.editable?'Your document is ready to edit. Changes are kept as a draft until you save.':'This document is read only. Its source is preserved.'),!!sourceNotice);
+  $('sidebar').classList.remove('open');$('toggle-plans').setAttribute('aria-expanded','false');if(!selection.line)window.scrollTo(0,0); notice(sourceNotice??'',!!sourceNotice);
 }
 async function persistDraft() {
   if (!state.doc || !state.base || (!state.dirty && !state.pending)) return;
@@ -192,8 +202,8 @@ async function persistDraft() {
       if (state.doc?.path !== path || state.draft?.id !== id) return;
       request.expectedDraftRevision = state.draft.revision;
       const stored = await api('draft/write', request);
-      if (state.doc?.path === path && state.draft?.id === id) { state.draft.revision = stored.revision; storeLocal(); state.recoveryStored=true; $('draft-status').textContent = 'Draft preserved locally · not saved to Markdown'; }
-    } catch (error) { $('draft-status').textContent = desktop?'Draft kept in Runlist':'Draft kept in browser'; notice(error.code === 'draft-conflict' ? 'Another editor updated the disk draft. Your text is kept locally; recover or copy it before proceeding.' : `Draft kept ${desktop?'in Runlist':'in browser'}. ${error.message}`, true); }
+      if (state.doc?.path === path && state.draft?.id === id) { state.draft.revision = stored.revision; storeLocal(); state.recoveryStored=true; $('draft-status').textContent = state.dirty ? 'Unsaved' : ''; $('draft-status').title = state.dirty ? 'Draft stored on this computer' : ''; }
+    } catch (error) { $('draft-status').textContent = 'Unsaved'; $('draft-status').title = 'Local draft storage failed'; notice(error.code === 'draft-conflict' ? 'Another editor updated the disk draft. Your text is kept locally; recover or copy it before proceeding.' : `Draft kept ${desktop?'in Runlist':'in browser'}. ${error.message}`, true); }
   };
   persistence = persistence.then(run,run); await persistence;
 }
@@ -210,8 +220,9 @@ async function recover() {
   state.base = { source:r.baseSource, revision:r.baseRevision }; state.draftSource = r.source; state.body = splitSource(r.source).body.replaceAll('\r\n','\n');
   state.draft = r.location === key() ? r.draft : null; state.pending = r.pending; state.lastSave = r.lastSave;
   $('body-editor').value = state.body; $('recovery').hidden = true; updateDirty(); storeLocal(); view('edit');
-  if (state.pending) notice('An interrupted save is retained. Review changes and retry to learn its original outcome.');
-  else notice('Draft recovered. Review changes before saving.');
+  if (state.pending) notice('An interrupted save is retained. Review changes and retry to learn its original outcome.',false,{persistent:true});
+  else notice('Draft recovered.');
+  $('draft-status').textContent = 'Unsaved'; $('draft-status').title = 'Recovered draft';
   if (state.base.revision !== state.doc.revision && !state.pending) conflict({ details:{ currentRevision:state.doc.revision, currentSource:state.doc.source } });
 }
 async function clearDraft() {
@@ -226,7 +237,7 @@ async function save() {
   // Retain the original request identity on disk before publication, even if renderer storage is later lost.
   await persistDraft();
   if(!state.recoveryStored)throw new Error('Preserve the draft and operation identity before saving.');
-  storeLocal(); state.busy = true; $('workspace').inert = true; updateDirty(); notice('Saving the reviewed source…');
+  storeLocal(); state.busy = true; $('workspace').inert = true; updateDirty(); notice('Saving…',false,{persistent:true});
   try {
     const result = await api(state.pending.kind === 'undo' ? 'undo' : 'save',state.pending), pending = state.pending;
     const current = await api(`document?path=${encodeURIComponent(state.doc.path)}`);
@@ -244,8 +255,8 @@ async function save() {
     state.doc = current; state.draftSource = current.source; state.base = { source:current.source, revision:current.revision }; state.body = splitSource(current.source).body.replaceAll('\r\n','\n');
     state.dirty = false; storeLocal(); let cleanupError = null;
     try { await clearDraft(); } catch (error) { cleanupError = error; }
-    $('body-editor').value = state.body; $('draft-status').textContent = 'Saved source'; storeLocal(); renderDocumentSummary(); renderEvidence(); view('edit');
-    notice(cleanupError ? `Saved to Markdown. Recovery draft retained: ${cleanupError.message}` : pending.kind === 'undo' ? 'Undid the save. The CLI reads the same file.' : 'Saved to Markdown. The CLI reads the same file.', !!cleanupError);
+    $('body-editor').value = state.body; $('draft-status').textContent = ''; $('draft-status').title = ''; storeLocal(); renderDocumentSummary(); renderEvidence(); view('edit');
+    notice(cleanupError ? `Saved to Markdown. Recovery draft retained: ${cleanupError.message}` : pending.kind === 'undo' ? 'Undid the save.' : 'Saved to Markdown.', !!cleanupError);
   } catch (error) {
     if (error.code === 'revision-conflict') { state.pending = null; storeLocal(); conflict(error); }
     else if (['repair-required','operation-pending'].includes(error.code)) {
@@ -283,51 +294,57 @@ async function bootstrap(token) {
 }
 async function showLibrary() {
   if(state.busy)throw new Error('Wait for the current operation before returning to the library.');
+  records.beforeLeave?.();
   await yardstick.beforeLeave();
   clearTimeout(draftTimer);
   if(state.doc&&(state.dirty||state.pending)){storeLocal();await persistDraft();if(!state.recoveryStored)throw new Error('Preserve your current draft before leaving the document.');}
   state.mode='home';blockEditor.hideTools();$('records-home').hidden=true;records.deactivate();changes.deactivate();filing.deactivate();
-  $('workspace').classList.add('library-start');$('evidence').classList.remove('outline-open');
+  $('workspace').classList.add('library-start');$('evidence').classList.remove('outline-open');$('toggle-outline').setAttribute('aria-expanded','false');
   $('document').hidden=true;$('empty').hidden=false;$('doc-path').textContent='';
   $('sidebar').classList.remove('open');$('toggle-plans').setAttribute('aria-expanded','false');
   const url=new URL(location.href);for(const key of ['path','ref','from','view','record'])url.searchParams.delete(key);history.replaceState(null,'',url);
   library.render();window.scrollTo(0,0);
-  notice(state.doc&&(state.dirty||state.pending)?'Library ready. Your document draft stays available when you reopen it.':'Library ready.');
+  notice();
 }
 $('document-changes').onclick=guarded(()=>changes.show());
+// Native details keeps checkout utilities available by mouse and keyboard.
+document.addEventListener('click',event=>{const menu=$('workspace-menu');if(menu.open&&(!menu.contains(event.target)||event.target.closest('button')))menu.open=false;});
+document.addEventListener('keydown',event=>{const menu=$('workspace-menu');if(event.key==='Escape'&&menu.open){menu.open=false;menu.querySelector('summary').focus();}});
 $('library-home').onclick=guarded(showLibrary);
 $('back-library').onclick=guarded(showLibrary);
 $('toggle-plans').onclick = () => $('toggle-plans').setAttribute('aria-expanded',String($('sidebar').classList.toggle('open')));
 for (const name of ['read','edit','review','source']) $('tab-' + name).onclick = guarded(() => view(name));
-$('edit').onclick = guarded(() => view(state.dirty ? 'review' : 'edit')); $('review').onclick = guarded(() => view('review')); $('back-edit').onclick = () => view('edit');
+$('edit').onclick = guarded(() => view(state.dirty || state.pending ? 'review' : 'edit',{focus:true})); $('review').onclick = guarded(() => view('review',{focus:true})); $('back-edit').onclick = guarded(() => view('edit',{focus:true}));
 function bodyChanged(body) {
   state.body = body;
   navigation.update();
   $('body-editor').value = body;
   storeLocal();
-  try { updateDirty(); storeLocal(); $('draft-status').textContent = state.dirty ? 'Saving draft…' : 'Saved source'; clearTimeout(draftTimer); if(state.dirty) draftTimer = setTimeout(() => persistDraft(),500); }
+  try { updateDirty(); storeLocal(); if(!noticeError)notice(); $('draft-status').textContent = state.dirty ? 'Unsaved' : ''; $('draft-status').title = state.dirty ? 'Not saved to the file' : ''; clearTimeout(draftTimer); if(state.dirty) draftTimer = setTimeout(() => persistDraft(),500); }
   catch (error) { $('save').disabled = true; notice(error.message,true); }
 }
 $('body-editor').oninput = () => bodyChanged($('body-editor').value);
 $('toggle-markdown').onclick = () => {
+  if(state.mode!=='edit')view('edit');
   const showing = $('markdown-fallback').hidden;
   $('markdown-fallback').hidden = !showing; $('block-editor').hidden = showing;
   $('toggle-markdown').textContent = showing ? 'Back to document' : 'Edit Markdown';
   $('toggle-markdown').setAttribute('aria-expanded',String(showing));
+  $('evidence').classList.remove('outline-open');$('toggle-outline').setAttribute('aria-expanded','false');
   if (showing) { $('body-editor').value=state.body; $('body-editor').focus(); }
   else { blockEditor.set(state.body,{readOnly:!!state.pending}); editorPath=state.doc.path; }
 };
 $('save').onclick = guarded(save);
-$('cancel').onclick = guarded(async () => { await persistDraft(); view('read'); notice(state.dirty ? 'Reading your draft preview. Changes are not saved to the file.' : 'Reading saved source.'); });
-$('discard').onclick = guarded(async () => { if (state.pending) throw new Error('Inspect or retry the interrupted save before discarding its recovery data.'); await clearDraft(); state.body = splitSource(state.doc.source).body.replaceAll('\r\n','\n'); state.base = { source:state.doc.source, revision:state.doc.revision }; state.draftSource = state.doc.source; state.pending = null; state.conflict = null; $('conflict').hidden = true; $('body-editor').value = state.body; storeLocal(); $('draft-status').textContent = 'Saved source'; view('edit'); notice('Changes discarded. The Markdown file is unchanged.'); });
+$('cancel').onclick = guarded(async () => { await persistDraft(); view('read'); });
+$('discard').onclick = guarded(async () => { if (state.pending) throw new Error('Inspect or retry the interrupted save before discarding its recovery data.'); await clearDraft(); state.body = splitSource(state.doc.source).body.replaceAll('\r\n','\n'); state.base = { source:state.doc.source, revision:state.doc.revision }; state.draftSource = state.doc.source; state.pending = null; state.conflict = null; $('conflict').hidden = true; $('body-editor').value = state.body; storeLocal(); $('draft-status').textContent = ''; $('draft-status').title = ''; view('edit'); notice('Changes discarded.'); });
 $('recover').onclick = guarded(recover);
 $('discard-recovery').onclick = guarded(async () => {
   const r = state.recovery;
   if (r?.pending) throw new Error('This draft contains an interrupted save. Recover it and inspect the outcome before discarding.');
   if (r?.draft?.revision) await api('draft/discard',{ path:state.doc.path,draftId:r.draft.id,expectedDraftRevision:r.draft.revision });
-  if (r) localStorage.removeItem(r.location); state.recovery = null; $('recovery').hidden = true; notice('Recovery draft discarded. The file is unchanged.');
+  if (r) localStorage.removeItem(r.location); state.recovery = null; $('recovery').hidden = true; notice('Draft discarded.');
 });
-$('review-merge').onclick = guarded(async () => { const c = state.conflict; if (!c) return; state.draftSource = rebaseSourceStage(state.base.source,state.draftSource ?? state.base.source,c.currentSource); state.base = { source:c.currentSource, revision:c.currentRevision }; state.pending = null; state.conflict = null; $('conflict').hidden = true; storeLocal(); await persistDraft(); view('review'); notice('Review the merged draft against the current file before saving.'); });
+$('review-merge').onclick = guarded(async () => { const c = state.conflict; if (!c) return; state.draftSource = rebaseSourceStage(state.base.source,state.draftSource ?? state.base.source,c.currentSource); state.base = { source:c.currentSource, revision:c.currentRevision }; state.pending = null; state.conflict = null; $('conflict').hidden = true; storeLocal(); await persistDraft(); view('review',{focus:true}); notice('Review the merged draft against the current file before saving.'); });
 $('use-current').onclick = guarded(async () => { await persistDraft(); state.doc = await api(`document?path=${encodeURIComponent(state.doc.path)}`); $('reading').innerHTML = markdownHtml(state.doc.source,linked); view('source'); notice('Current source is shown. Your draft and conflict review are retained.'); });
 $('inspect-pending').onclick = guarded(() => inspectOperation(state.pending.operationId));
 $('settle-operation').onclick = guarded(async () => {
@@ -354,13 +371,14 @@ $('undo').onclick = guarded(async () => {
   } finally { state.busy = false; $('workspace').inert = false; updateDirty(); }
 });
 $('reading').addEventListener('click',event=>{const anchor=event.target.closest('a');if(!anchor||event.metaKey||event.ctrlKey||event.shiftKey)return;const url=new URL(anchor.href,location.href);if(url.origin!==location.origin||!url.searchParams.has('ref'))return;event.preventDefault();guarded(async()=>{const target=await api(`link?${new URLSearchParams({ref:url.searchParams.get('ref'),from:url.searchParams.get('from')??''})}`);if(!target)throw new Error('This linked document is unavailable or outside this library.');await open(target.path);})();});
-$('copy-source').onclick = guarded(async () => { await copyText(state.doc.source); notice('Canonical Markdown source copied.'); });
+$('copy-source').onclick = guarded(async () => { await copyText(state.doc.source); notice('Source copied.'); });
 $('disconnect').onclick = guarded(async () => { await beforeDesktopLeave(); await api('logout',{}); $('workspace').hidden = true; $('connect-panel').hidden = false; for(const id of ['disconnect','new-document','quick-open','open-recovery'])$(id).hidden=true; notice('Disconnected. Private drafts are retained locally.'); await desktopDisconnected(); });
 $('connect-form').onsubmit = event => { event.preventDefault(); guarded(async () => { const value = $('access').value.trim(); let token = value; try { token = new URLSearchParams(new URL(value).hash.slice(1)).get('connect') ?? value; } catch { /* A raw token is also accepted. */ } await bootstrap(token); $('access').value = ''; })(); };
 window.addEventListener('beforeunload', event => { if (state.dirty || state.pending) { storeLocal(); if (!state.recoveryStored) { event.preventDefault(); event.returnValue = ''; } } });
-document.addEventListener('keydown', event => { if (document.querySelector('dialog[open]')) return; if ((event.metaKey || event.ctrlKey) && event.key === 's') { event.preventDefault(); if (state.doc && state.dirty) guarded(() => view('review'))(); } });
+document.addEventListener('keydown', event => { if (document.querySelector('dialog[open]')) return; if ((event.metaKey || event.ctrlKey) && event.key === 's') { event.preventDefault(); if (state.doc && state.dirty) guarded(() => view('review',{focus:true}))(); } });
 async function beforeDesktopLeave() {
   if(state.busy)throw new Error('Wait for the current operation before switching folders or quitting.');
+  records.beforeLeave?.();
   await yardstick.beforeLeave();
   if($('template-dialog').open||$('lifecycle-dialog')?.open||$('create-dialog').open||$('git-commit-dialog').open||$('filter-dialog').open||$('record-review')&&!$('record-review').hidden)throw new Error('Close the current review or template editor before switching folders or quitting.');
   clearTimeout(draftTimer);

package/assets/app/document-create.mjs

@@ -54,7 +54,7 @@ export function documentCreation({$,api,checkout,state,beforeNavigate,open,libra
     if(template&&!catalog.templates.some(t=>t.name===template))throw new Error(catalog.recordError??'This record template is unavailable.');
     $('create-template').replaceChildren(...catalog.templates.map(t=>new Option(({hub:'Hub',plan:'Plan',flag:'Flag',decision:'Decision'})[t.name]??'Document',t.name)));
     $('create-folders').replaceChildren(...catalog.roots.map(root=>{const option=document.createElement('option');option.value=root;return option;}));
-    $('create-form').reset();setOptions();chooseTemplate();filenameEdited=false;review=null;request=null;feedback('');$('create-diagnostics').replaceChildren();
+    $('create-form').reset();$('create-file-options').removeAttribute('open');setOptions();chooseTemplate();filenameEdited=false;review=null;request=null;feedback('');$('create-diagnostics').replaceChildren();
     try {
       const stored=JSON.parse(localStorage.getItem(key())??'null');
       if(stored){if(catalog.templates.some(t=>t.name===stored.form?.template)){$('create-template').value=stored.form.template;chooseTemplate();}for(const [field,id] of Object.entries({title:'create-name',folder:'create-folder',filename:'create-filename',status:'create-status',body:'create-body',severity:'create-severity'}))if(typeof stored.form?.[field]==='string')$(id).value=stored.form[field];if(Array.isArray(stored.form?.options)){setOptions(stored.form.options);chooseTemplate();}review=stored.review;request=stored.request;filenameEdited=!!stored.form?.filename;}
@@ -65,6 +65,7 @@ export function documentCreation({$,api,checkout,state,beforeNavigate,open,libra
     $('create-preview-button').disabled=!catalog.templates.length;renderReview();dialog.showModal();(review?$('create-confirm'):$('create-name')).focus();
     if(!catalog.templates.length){$('create-preview-button').disabled=true;feedback('This checkout has no supported document templates. Configure a plan or doc type through the CLI.',true);}
   }
+  $('create-form').addEventListener('invalid',event=>{if(event.target.closest('#create-file-options'))$('create-file-options').setAttribute('open','');},true);
   $('create-template').onchange=()=>{chooseTemplate();keep();};
   $('create-filename').oninput=()=>{filenameEdited=true;keep();};
   $('create-name').oninput=()=>{if(!filenameEdited&&!selected()?.native){const slug=$('create-name').value.toLowerCase().replace(/[\s_]+/g,'-').replace(/[^a-z0-9-]/g,'').replace(/-+/g,'-').replace(/^-|-$/g,'').slice(0,120);$('create-filename').value=slug?slug+'.md':'';}keep();};
@@ -75,7 +76,7 @@ export function documentCreation({$,api,checkout,state,beforeNavigate,open,libra
   $('create-inspect').onclick=()=>busy(async()=>{const inspected=await api('create/inspect',{operationId:review.operationId});current();review=inspected;keep();feedback(review?`Creation is ${review.state}.${review.currentRevision&&review.currentRevision!==review.revision?' The destination changed and will not be overwritten.':''}`:'No creation review found.');});
   $('create-confirm').onclick=()=>busy(async()=>{
     if(review.state!=='committed') {const committed=await api('create/commit',{operationId:review.operationId});current();review=committed;keep();}
-    current();const path=review.path,record=review.record;localStorage.removeItem(key());dialog.close();state.busy=false;await library.load({refresh:true});current();if(record&&createdRecord)await createdRecord(record);else await open(path);notice(record?`Created an open ${record.type}. Ready for review.`:'Created local Markdown. Ready to edit.');
+    current();const path=review.path,record=review.record;localStorage.removeItem(key());dialog.close();state.busy=false;await library.load({refresh:true});current();if(record&&createdRecord)await createdRecord(record);else await open(path);notice(record?`${record.type==='flag'?'Flag':'Decision'} created.`:'Document created.');
   });
   $('create-discard').onclick=()=>busy(async()=>{if(review)await api('create/discard',{operationId:review.operationId});current();localStorage.removeItem(key());review=null;request=null;dialog.close();notice('New document draft discarded.');});
   $('create-close').onclick=()=>{if(!state.busy&&keep()){sequence++;dialog.close();}};

package/assets/app/document-lifecycle.mjs

@@ -1,5 +1,7 @@
 export function documentLifecycle({state,$,api,checkout,open,library,notice}){
  const key=path=>`runlist:lifecycle:${checkout()}:${encodeURIComponent(path)}`,dialog=$('lifecycle-dialog');let pending=null,blocked=false,formEnabled=true;
+ const canApply=()=>!blocked&&pending?.state==='reviewed';
+ const remember=()=>localStorage.setItem(key(pending.path),JSON.stringify(pending));
  const retained=path=>{try{const direct=JSON.parse(localStorage.getItem(key(path))??'null');if(direct)return direct;for(let i=0;i<localStorage.length;i++){const location=localStorage.key(i);if(location.startsWith(`runlist:lifecycle:${checkout()}:`)){const value=JSON.parse(localStorage.getItem(location));if(value?.newPath===path)return value;}}}catch{}return null;};
  async function resolveInitial(initial){const old=retained(initial);if(old&&old.path===initial){const result=await api('lifecycle/inspect',{operationId:old.operationId});if(result?.state==='committed'){library.relocated(old.path,result.newPath);localStorage.removeItem(key(old.path));return result.newPath;}if(result?.current&&result.newPath!==initial)return result.newPath;}return initial;}
  async function show(){if(!state.doc||state.busy)return;const doc=state.doc,info=await api(`lifecycle?path=${encodeURIComponent(doc.path)}`);$('lifecycle-path').textContent=`${doc.title} · ${doc.path}`;const root=$('lifecycle-content');root.replaceChildren();
@@ -8,16 +10,23 @@ export function documentLifecycle({state,$,api,checkout,open,library,notice}){
  for(const status of info.statuses.filter(s=>s!==info.current))form.querySelector('select').add(new Option(status,status));root.append(form);
  blocked=!info.enabled||state.dirty||state.pending;formEnabled=info.enabled;form.hidden=!formEnabled;const message=document.createElement('p');message.id='lifecycle-unavailable';message.className='inline-note';message.setAttribute('role','status');if(blocked){message.textContent=!info.enabled?info.reason:'Save or discard the document draft before changing its lifecycle status.';root.append(message);for(const input of form.querySelectorAll('input,select,textarea,button'))input.disabled=true;}
  const review=document.createElement('section');review.id='lifecycle-review';review.hidden=true;root.append(review);pending=retained(doc.path);if(pending&&![pending.path,pending.newPath].includes(doc.path))pending=null;if(pending)renderReview();
- form.onsubmit=async event=>{event.preventDefault();if(state.busy||blocked)return;state.busy=true;$('lifecycle-close').disabled=true;$('lifecycle-review-button').disabled=true;try{const request={path:doc.path,status:$('lifecycle-status').value,note:$('lifecycle-note').value,expectedRevision:doc.revision,operationId:crypto.randomUUID()};pending={...request,report:'Review not yet received.'};localStorage.setItem(key(pending.path),JSON.stringify(pending));const result=await api('lifecycle/preview',request);pending={...pending,...result};localStorage.setItem(key(pending.path),JSON.stringify(pending));renderReview();}catch(error){if(pending){renderReview();$('lifecycle-feedback').textContent=`${error.message} Inspect this operation, or return to the form to review again.`;}notice(error.message,true);}finally{state.busy=false;$('lifecycle-close').disabled=false;$('lifecycle-review-button').disabled=false;}};
+ form.onsubmit=async event=>{event.preventDefault();if(state.busy||blocked)return;state.busy=true;$('lifecycle-close').disabled=true;$('lifecycle-review-button').disabled=true;try{const request={path:doc.path,status:$('lifecycle-status').value,note:$('lifecycle-note').value,expectedRevision:doc.revision,operationId:crypto.randomUUID()};pending={...request,state:'preparing',report:'Review not yet received.'};localStorage.setItem(key(pending.path),JSON.stringify(pending));const result=await api('lifecycle/preview',request);pending={...pending,...result};localStorage.setItem(key(pending.path),JSON.stringify(pending));renderReview();}catch(error){if(pending){renderReview();$('lifecycle-feedback').textContent=`${error.message} Inspect this operation, or return to the form to review again.`;}notice(error.message,true);}finally{state.busy=false;$('lifecycle-close').disabled=false;$('lifecycle-review-button').disabled=false;}};
  dialog.showModal();
  }
- function renderReview(){$('lifecycle-form').hidden=true;const root=$('lifecycle-review');root.hidden=false;root.replaceChildren();const heading=document.createElement('h3');heading.textContent=`Change to ${pending.status}`;const report=document.createElement('pre');report.className='lifecycle-report';report.textContent=pending.report;const confirm=document.createElement('button');confirm.id='lifecycle-confirm';confirm.className='primary';confirm.textContent='Apply status change';confirm.disabled=blocked;const back=document.createElement('button');back.className='quiet';back.textContent='Back to form';back.id='lifecycle-back';const inspect=document.createElement('button');inspect.className='quiet';inspect.textContent='Inspect operation';inspect.id='lifecycle-inspect';const feedback=document.createElement('p');feedback.id='lifecycle-feedback';feedback.setAttribute('role','status');root.append(heading,report,confirm,back,inspect,feedback);
- back.onclick=()=>{const previous=pending;localStorage.removeItem(key(pending.path));pending=null;root.hidden=true;$('lifecycle-form').hidden=!formEnabled;$('lifecycle-status').value=previous.status;$('lifecycle-note').value=previous.note;};
- inspect.onclick=async()=>{try{const result=await api('lifecycle/inspect',{operationId:pending.operationId});report.textContent=result?.report??'No lifecycle review was retained. Return to the form and review again.';feedback.textContent=result?`Operation is ${result.state}.`:'No operation found.';if(result?.failure)feedback.textContent+=` ${result.failure.message}`;if(result?.state==='running'){feedback.textContent+=' Inspect CLI transactions before starting another change.';if(result.canAcknowledge)acknowledge(result,root,feedback);else feedback.textContent+=' The runner is still active or cannot be verified as stopped.';}}catch(error){feedback.textContent=error.message;}};
- confirm.onclick=async()=>{if(state.busy||blocked)return;state.busy=true;for(const button of root.querySelectorAll('button'))button.disabled=true;$('lifecycle-close').disabled=true;
- try{const result=await api('lifecycle/commit',{operationId:pending.operationId}),old=pending.path;library.relocated(old,result.newPath);localStorage.removeItem(key(pending.path));pending=null;state.busy=false;dialog.close();await open(result.newPath);await library.load({refresh:true});notice('Lifecycle status saved. Source, references and history follow the CLI rules.');}
- catch(error){feedback.textContent=pending?`${error.message} Your review is retained. Inspect the operation or reload the document before reviewing again.`:`Status saved, but the view could not be refreshed. ${error.message}`;notice(feedback.textContent,true);}
- finally{state.busy=false;for(const button of root.querySelectorAll('button'))button.disabled=false;confirm.disabled=blocked;$('lifecycle-close').disabled=false;}
+ function renderReview(){$('lifecycle-form').hidden=true;const root=$('lifecycle-review');root.hidden=false;root.replaceChildren();const heading=document.createElement('h3');heading.textContent=`Change to ${pending.status}`;const report=document.createElement('pre');report.className='lifecycle-report';report.textContent=pending.report;const confirm=document.createElement('button');confirm.id='lifecycle-confirm';confirm.className='primary';confirm.textContent='Apply status change';confirm.disabled=!canApply();const back=document.createElement('button');back.className='quiet';back.textContent='Back to form';back.id='lifecycle-back';const inspect=document.createElement('button');inspect.className='quiet';inspect.textContent='Inspect operation';inspect.id='lifecycle-inspect';const feedback=document.createElement('p');feedback.id='lifecycle-feedback';feedback.setAttribute('role','status');root.append(heading,report,confirm,back,inspect,feedback);
+ back.onclick=()=>{if(state.busy)return;const previous=pending;localStorage.removeItem(key(pending.path));pending=null;root.hidden=true;$('lifecycle-form').hidden=!formEnabled;$('lifecycle-status').value=previous.status;$('lifecycle-note').value=previous.note;};
+ inspect.onclick=async()=>{
+  if(state.busy)return;state.busy=true;root.querySelector('#lifecycle-acknowledge')?.remove();for(const button of root.querySelectorAll('button'))button.disabled=true;$('lifecycle-close').disabled=true;
+  try{const result=await api('lifecycle/inspect',{operationId:pending.operationId});pending={...pending,...result,state:result?.state??'missing'};remember();report.textContent=result?.report??'No lifecycle review was retained. Return to the form and review again.';feedback.textContent=result?`Operation is ${result.state}.`:'No operation found.';
+   if(result?.state==='committed'){const old=pending.path;library.relocated(old,result.newPath);localStorage.removeItem(key(old));pending=null;state.busy=false;dialog.close();await open(result.newPath);await library.load({refresh:true});notice('The status change was already saved.');return;}
+   if(result?.failure)feedback.textContent+=` ${result.failure.message}`;if(result?.state==='running'){feedback.textContent+=' Inspect CLI transactions before starting another change.';if(result.canAcknowledge)acknowledge(result,root,feedback);else feedback.textContent+=' The runner is still active or cannot be verified as stopped.';}
+  }catch(error){if(pending){pending.state='uncertain';remember();}feedback.textContent=error.message;}
+  finally{state.busy=false;for(const button of root.querySelectorAll('button'))button.disabled=false;confirm.disabled=!canApply();$('lifecycle-close').disabled=false;}
+ };
+ confirm.onclick=async()=>{if(state.busy||!canApply())return;state.busy=true;for(const button of root.querySelectorAll('button'))button.disabled=true;$('lifecycle-close').disabled=true;
+ try{pending.state='submitting';remember();const result=await api('lifecycle/commit',{operationId:pending.operationId}),old=pending.path;library.relocated(old,result.newPath);localStorage.removeItem(key(pending.path));pending=null;state.busy=false;dialog.close();await open(result.newPath);await library.load({refresh:true});notice('Lifecycle status saved. Source, references and history follow the CLI rules.');}
+ catch(error){if(pending){pending.state='uncertain';remember();}feedback.textContent=pending?`${error.message} Your review is retained. Inspect the operation or reload the document before reviewing again.`:`Status saved, but the view could not be refreshed. ${error.message}`;notice(feedback.textContent,true);}
+ finally{state.busy=false;for(const button of root.querySelectorAll('button'))button.disabled=false;confirm.disabled=!canApply();$('lifecycle-close').disabled=false;}
  };
  }
  function acknowledge(result,root,feedback){

package/assets/app/document-stages.mjs

@@ -11,12 +11,14 @@ export function documentStages({state,$,changed}) {
     if(!plan)return;
     current=readSourceStage(source);
     const definitions=state.doc.stageDefinitions??[],known=definitions.some(stage=>stage.word===current.word);
+    $('document-stage-fields').hidden=!definitions.length&&!current.word&&!current.invalid;
     select.replaceChildren(new Option('Unset · no stage',''),...definitions.map(stage=>new Option(stage.word,`word:${stage.word}`)));
     if(current.word&&!known){const option=new Option(`${current.word} · unknown`,`word:${current.word}`);option.disabled=true;select.add(option);}
     if(current.invalid){const option=new Option('Invalid metadata','@invalid');option.disabled=true;select.add(option);}
     select.value=current.invalid?'@invalid':current.word?`word:${current.word}`:'';
     select.disabled=!state.doc.editable||!!state.pending||state.busy;
     const definition=definitions.find(stage=>stage.word===current.word);
-    meaning.textContent=current.invalid?'This stage has unsupported metadata. Choose a configured stage or Unset, then review the change.':current.word&&!known?'This stage is not configured in this repository. Its current value is preserved until you choose a replacement.':definition?.meaning||(!definitions.length?'No stages are configured. Define taxonomy.milestones in runlist.config.mjs to choose a stage.':'Stage describes when this plan should ship. Changes stay in your draft until saved.');
+    meaning.textContent=current.invalid?'This stage has unsupported metadata. Choose a configured stage or Unset, then review the change.':current.word&&!known?'This stage is not configured in this repository. Its current value is preserved until you choose a replacement.':definition?.meaning||(!definitions.length?'No stages configured.':'');
+    meaning.hidden=!meaning.textContent;
   }};
 }

package/assets/app/document-views.mjs

@@ -4,6 +4,23 @@ const modes = Object.keys(panels);
 // Keep the active tab focusable, associate each tab with its panel, and provide
 // the conventional arrow/Home/End navigation without capturing editor keys.
 export function documentViews({$, view}) {
+  // Measure the actual chrome: titles and larger text can wrap.
+  const header = document.querySelector('.app-header'), toolbar = document.querySelector('.document-toolbar');
+  const tabs = document.querySelector('.view-tabs');
+  const measure = () => {
+    const height = node => node?.getBoundingClientRect?.().height ?? 0;
+    const style = document.documentElement?.style;
+    if (!style) return;
+    style.setProperty('--app-header-height', `${height(header)}px`);
+    style.setProperty('--workspace-top', `${height(header)}px`);
+    style.setProperty('--document-toolbar-height', `${height(toolbar)}px`);
+    style.setProperty('--document-tabs-height', `${height(tabs)}px`);
+  };
+  if (typeof ResizeObserver !== 'undefined') {
+    const observer = new ResizeObserver(measure);
+    for (const node of [header, toolbar, tabs]) if (node) observer.observe(node);
+  }
+  measure();
   $('document-tabs').addEventListener('keydown', event => {
     const current = modes.findIndex(mode => event.target === $('tab-' + mode));
     if (current < 0) return;
@@ -22,7 +39,12 @@ export function documentViews({$, view}) {
       next = (next + step + modes.length) % modes.length;
     }
   });
-  return {update(mode) {
+  return {focus(mode) {
+    const panel = $(panels[mode]);
+    // Only explicit primary actions move focus; rerenders preserve the caret.
+    const editor = mode === 'edit' ? (!$('markdown-fallback').hidden ? $('body-editor') : panel.querySelector('[data-editable][contenteditable="true"]')) : null;
+    (editor ?? panel).focus({preventScroll:true});
+  },update(mode) {
     for (const name of modes) {
       const selected = name === mode, tab = $('tab-' + name);
       tab.setAttribute('aria-selected', String(selected));

package/assets/app/editor-navigation.mjs

@@ -1,50 +1,43 @@
 import { documentOutline } from './outline.mjs';
-export function editorNavigation({state,editor,checkout,$,view,notice}) {
-  let entries=[], bookmarks=[], path='', active=null, previous=[],previousModel;
-  const storageKey=()=>`runlist:bookmarks:${checkout()}:${encodeURIComponent(state.doc.path)}`;
-  function persist() { try { localStorage.setItem(storageKey(),JSON.stringify(bookmarks)); } catch { notice('Bookmarks could not be saved in local editor storage.',true); } }
+export function editorNavigation({state,editor,$,view,notice}) {
+  let entries=[], path='', active=null;
   function jump(entry) {
     if (!entry || !state.doc) return;
     if (!['read','edit'].includes(state.mode)) view('edit');
     let target;
-    if (state.mode==='read') target=[...$('reading').querySelectorAll('h1,h2,h3,h4,h5,h6')][entries.indexOf(entry)];
+    if (state.mode==='read') { target=[...$('reading').querySelectorAll('h1,h2,h3,h4,h5,h6')][entries.indexOf(entry)]; if(target){target.tabIndex=-1;target.focus({preventScroll:true});} }
     else if (!$('markdown-fallback').hidden) { target=$('body-editor'); target.focus(); target.setSelectionRange(entry.offset,entry.offset); const lineHeight=parseFloat(getComputedStyle(target).lineHeight)||22; target.scrollTop=Math.max(0,(entry.line-3)*lineHeight); }
     else { target=[...editor.root.querySelectorAll('[data-block]')].find(e=>e.dataset.block===entry.id); if (!entry.locked) editor.focus(entry.id); }
-    target?.scrollIntoView({block:'center',behavior:'smooth'}); active=entry.key; highlight(); $('evidence').classList.remove('outline-open');
+    target?.scrollIntoView({block:'center',behavior:'smooth'}); active=entry.key; highlight(); outline(false);
   }
   function highlight() { for (const button of $('outline').querySelectorAll('[data-section]')) { const selected=button.dataset.section===active; button.setAttribute('aria-current',String(selected)); } }
-  function toggle(entry) { const index=bookmarks.findIndex(b=>b.key===entry.key); if(index<0) bookmarks.push({key:entry.key,title:entry.title}); else bookmarks.splice(index,1); persist(); render(); }
-  function row(entry, saved=false) {
+  function row(entry) {
     const div=document.createElement('div'); div.className='outline-row'; div.style.setProperty('--heading-level',entry.level ?? 1);
     const button=document.createElement('button'); button.className='section-link quiet'; button.textContent=entry.title; button.dataset.section=entry.key;
-    const found=entries.find(e=>e.key===entry.key); button.disabled=!found; button.title=found ? `Jump to ${entry.title} · line ${found.line}` : 'This heading was renamed or removed. Remove this bookmark or bookmark the new heading.';
-    button.onclick=()=>jump(found);
-    const star=document.createElement('button'); star.className='section-bookmark quiet'; const marked=bookmarks.some(b=>b.key===entry.key); star.textContent=marked?'★':'☆'; star.setAttribute('aria-label',`${marked?'Remove bookmark for':'Bookmark'} ${entry.title}`);star.setAttribute('aria-pressed',String(marked));star.onclick=()=>{if(found)toggle(found);else{bookmarks=bookmarks.filter(b=>b.key!==entry.key);persist();render();}};
-    div.append(button,star); if(saved&&!found) {const small=document.createElement('small');small.textContent='Heading unavailable';div.append(small);}return div;
+    button.title=`Jump to ${entry.title} · line ${entry.line}`;button.onclick=()=>jump(entry);
+    div.append(button);return div;
   }
   function render() {
     const query=$('section-filter').value.toLowerCase();
     $('outline').replaceChildren(...entries.filter(e=>e.title.toLowerCase().includes(query)).map(e=>row(e)));
     if(!$('outline').children.length)$('outline').textContent=query?'No matching headings.':'Add a heading to create a section.';
-    $('bookmarks').replaceChildren(...bookmarks.map(b=>row(b,true)));$('bookmark-empty').hidden=bookmarks.length>0;
     $('section-count').textContent=entries.length;highlight();
   }
   function update() {
     if(!state.doc)return;
-    const samePath=path===state.doc.path;
-    if(!samePath){path=state.doc.path;active=null;previous=[];try{const stored=JSON.parse(localStorage.getItem(storageKey())??'[]');bookmarks=Array.isArray(stored)?stored.filter(b=>typeof b.key==='string'&&typeof b.title==='string'):[];}catch{bookmarks=[];}$('section-filter').value='';}
+    if(path!==state.doc.path){path=state.doc.path;active=null;$('section-filter').value='';}
     const model=editor.source()===state.body?editor.blocks:undefined;
-    entries=documentOutline(state.body,model);
-    // Inline block identity survives typing and insertions, so heading renames
-    // also update their bookmarks. Source replacements leave unmatched bookmarks explicit.
-    if(samePath&&model&&model===previousModel){let changed=false;for(const b of bookmarks){const old=previous.find(e=>e.key===b.key),fresh=old&&entries.find(e=>e.id===old.id);if(fresh&&fresh.key!==b.key){b.key=fresh.key;b.title=fresh.title;changed=true;}}if(changed)persist();}
-    previous=entries;previousModel=model;render();
+    entries=documentOutline(state.body,model);render();
   }
   $('section-filter').oninput=render;
-  $('toggle-outline').onclick=()=>{$('evidence').classList.toggle('outline-open');$('section-filter').focus();};
-  $('close-outline').onclick=()=>$('evidence').classList.remove('outline-open');
+  function outline(show,restoreFocus=false){
+    $('evidence').classList.toggle('outline-open',show);$('toggle-outline').setAttribute('aria-expanded',String(show));
+    if(show)$('section-filter').focus();else if(restoreFocus)$('toggle-outline').focus();
+  }
+  $('toggle-outline').onclick=()=>outline(!$('evidence').classList.contains('outline-open'));
+  $('close-outline').onclick=()=>outline(false,true);
   $('add-section').onclick=()=>{if(!state.doc||state.busy||state.pending||!state.doc.editable)return;view('edit');if(!$('markdown-fallback').hidden)$('toggle-markdown').click();editor.mutate(()=>{const last=editor.blocks.filter(b=>!b.locked&&!['gap','comment'].includes(b.kind)).at(-1);const fresh=editor.insertAfter(last,'h2','New section');editor.render();editor.focus(fresh.id);});update();jump(entries.find(e=>e.id===editor.activeId));};
-  document.addEventListener('keydown',event=>{if(!state.doc||['home','records','filing'].includes(state.mode)||document.querySelector('dialog[open]'))return;if((event.metaKey||event.ctrlKey)&&event.shiftKey&&event.key.toLowerCase()==='j'){event.preventDefault();$('evidence').classList.add('outline-open');$('section-filter').focus();}if(event.altKey&&['PageDown','PageUp'].includes(event.key)){event.preventDefault();const index=entries.findIndex(e=>e.key===active);jump(entries[Math.max(0,Math.min(entries.length-1,index+(event.key==='PageDown'?1:-1)))]);}if(event.key==='Escape')$('evidence').classList.remove('outline-open');});
+  document.addEventListener('keydown',event=>{if(!state.doc||['home','records','filing'].includes(state.mode)||document.querySelector('dialog[open]'))return;if((event.metaKey||event.ctrlKey)&&event.shiftKey&&event.key.toLowerCase()==='j'){event.preventDefault();outline(true);}if(event.altKey&&['PageDown','PageUp'].includes(event.key)){event.preventDefault();const index=entries.findIndex(e=>e.key===active);jump(entries[Math.max(0,Math.min(entries.length-1,index+(event.key==='PageDown'?1:-1)))]);}if(event.key==='Escape'&&$('evidence').classList.contains('outline-open'))outline(false,true);});
   $('section-filter').onkeydown=event=>{if(event.key==='Enter'){event.preventDefault();jump(entries.find(e=>e.title.toLowerCase().includes($('section-filter').value.toLowerCase())));}};
   let scheduled=false;window.addEventListener('scroll',()=>{if(scheduled||!state.doc||!['read','edit'].includes(state.mode)||!$('markdown-fallback').hidden)return;scheduled=true;requestAnimationFrame(()=>{scheduled=false;const nodes=state.mode==='read'?[...$('reading').querySelectorAll('h1,h2,h3,h4,h5,h6')]:entries.map(e=>[...editor.root.querySelectorAll('[data-block]')].find(n=>n.dataset.block===e.id));let current=entries[0];for(let i=0;i<nodes.length;i++)if(nodes[i]?.getBoundingClientRect().top<260)current=entries[i];if(current){active=current.key;highlight();}});},{passive:true});
   return {update,jumpTo:section=>{update();const entry=entries.find(e=>e.line===section.line&&e.title.slice(0,200)===section.title)||entries.find(e=>e.title.slice(0,200)===section.title);if(entry)jump(entry);else notice('This section changed since the search. Use the document outline to find it.',true);}};