runlist 0.0.0 → 0.94.2

package/assets/app/block-model.mjs

@@ -0,0 +1,52 @@
+// Block boundaries retain the original source. Only the block being edited is
+// rewritten; gaps, comments, unsupported syntax, and managed history stay raw.
+export function parseBlocks(body) {
+  const lines = body.match(/[^\n]*\n|[^\n]+$/g) ?? [];
+  const blocks = []; let i = 0, id = 0;
+  const line = n => (lines[n] ?? '').replace(/\n$/, '');
+  const add = (kind, start, end, extra = {}) => blocks.push({id:String(id++),kind,raw:lines.slice(start,end).join(''),...extra});
+  const special = s => /^(?: {0,3}(?:#{1,6}\s|[-*+] |\d+[.)] |`{3,}|~{3,})|>|\s*<!--|\s*$)/.test(s);
+  while (i < lines.length) {
+    const start = i, s = line(i), heading = s.match(/^( {0,3})(#{1,6})(\s+)(.*?)(\s+#+\s*)?$/);
+    if (heading && heading[2].length === 2 && /^Version History\s*$/i.test(heading[4])) { add('history',i,lines.length,{locked:true}); break; }
+    if (!s.trim()) { while (i < lines.length && !line(i).trim()) i++; add('gap',start,i); continue; }
+    if (/^\s*<!--/.test(s)) { while (i < lines.length && !line(i++).includes('-->')) {} add('comment',start,i); continue; }
+    const fence = s.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
+    if (fence) {
+      i++; while (i < lines.length && !new RegExp(`^ {0,3}${fence[1][0]}{${fence[1].length},}\\s*$`).test(line(i))) i++;
+      // Unclosed fences remain source-editable; do not invent a closing fence.
+      if (i === lines.length) { add('source',start,i); continue; }
+      const end = i++; add('code',start,i,{prefix:lines[start],text:lines.slice(start+1,end).join('').replace(/\n$/,''),suffix:'\n'+lines[end]}); continue;
+    }
+    if (s.includes('|') && /^\s*\|?\s*:?-{3,}/.test(line(i+1))) { i+=2; while (i<lines.length && line(i).includes('|') && line(i).trim()) i++; add('source',start,i); continue; }
+    if (heading) { i++; add('h'+heading[2].length,start,i,{prefix:heading[1]+heading[2]+heading[3],text:heading[4],suffix:(heading[5]??'')+(lines[start].endsWith('\n')?'\n':'')}); continue; }
+    const item = s.match(/^( {0,3})([-*+] |\d+[.)] )(?:\[([ xX])\] )?(.*)$/);
+    if (item) {
+      i++; // Multiline/nested items need a source fallback, rather than losing indentation.
+      while (i<lines.length && /^\s{2,}\S/.test(line(i))) i++;
+      if (i>start+1) { add('source',start,i); continue; }
+      add(item[3]!==undefined?'task':/\d/.test(item[2])?'number':'bullet',start,i,{prefix:item[1]+item[2]+(item[3]!==undefined?`[${item[3]}] `:''),text:item[4],checked:item[3]!==undefined&&item[3]!==' ',suffix:lines[start].endsWith('\n')?'\n':''}); continue;
+    }
+    if (/^>\s?/.test(s)) { i++; add('quote',start,i,{prefix:s.match(/^>\s?/)[0],text:s.replace(/^>\s?/,''),suffix:lines[start].endsWith('\n')?'\n':''}); continue; }
+    if (/^\s*(?:---+|\*\*\*+|___+)\s*$/.test(s)) { i++; add('divider',start,i); continue; }
+    i++; while (i<lines.length && !special(line(i)) && !(line(i).includes('|') && /^\s*\|?\s*:?-{3,}/.test(line(i+1)))) i++;
+    const raw = lines.slice(start,i).join('');
+    add(/^ {4}|^\t|^\s*</.test(s)?'source':'paragraph',start,i,{prefix:'',text:raw.replace(/\n$/,''),suffix:raw.endsWith('\n')?'\n':''});
+  }
+  return blocks;
+}
+export const blocksSource = blocks => blocks.map(b=>b.raw).join('');
+export function rewriteBlock(block, text) {
+  if (block.locked) throw new Error('Managed history is read only.');
+  block.text = text;
+  block.raw = block.prefix + text + block.suffix;
+  return block;
+}
+export const blockPrefixes = {paragraph:'',h1:'# ',h2:'## ',h3:'### ',bullet:'- ',number:'1. ',task:'- [ ] ',quote:'> '};
+export function convertBlock(block, kind) {
+  if (!(kind in blockPrefixes) || block.locked || ['source','code','history'].includes(block.kind)) return false;
+  block.kind=kind; block.prefix=blockPrefixes[kind]; block.checked=false;
+  // ATX heading closing markers belong to the previous block kind.
+  block.suffix=block.suffix.endsWith('\n')?'\n':'';
+  rewriteBlock(block,block.text); return true;
+}

package/assets/app/document-create.mjs

@@ -0,0 +1,86 @@
+import {markdownHtml,escapeHtml as esc,splitSource} from './shared.mjs';
+import {nativeContent} from './record-navigation.mjs';
+
+export function documentCreation({$,api,checkout,state,beforeNavigate,open,library,notice,createdRecord}) {
+  const dialog=$('create-dialog');let catalog,review=null,request=null,filenameEdited=false,scope='',sequence=0;
+  $('create-preview').addEventListener('click',event=>{if(event.target.closest('a'))event.preventDefault();});
+  const key=()=>`runlist:create:${scope||checkout()}`;
+  const current=()=>{if(scope!==checkout())throw new Error('The checkout changed. This creation review is retained for its original checkout.');};
+  const selected=()=>catalog?.templates.find(t=>t.name===$('create-template').value);
+  const alternatives=()=>[...$('create-options').children].map(row=>({label:row.querySelector('[data-label]').value,description:row.querySelector('[data-description]').value,consequences:[...row.querySelectorAll('[data-consequence]')].flatMap(field=>field.value.trim()?[{kind:field.dataset.consequence,text:field.value}]:[])}));
+  const form=()=>({template:$('create-template').value,title:$('create-name').value,folder:$('create-folder').value,filename:$('create-filename').value,status:$('create-status').value,body:$('create-body').value,...(selected()?.name==='flag'?{severity:$('create-severity').value}:selected()?.name==='decision'?{options:alternatives()}:{})});
+  function optionRow(option={}){
+    const row=document.createElement('section');row.className='create-alternative';
+    row.innerHTML=`<div class="create-alternative-heading"><h3>Alternative</h3><button type="button" class="quiet small" data-remove>Remove alternative</button></div><label>Label<input data-label required maxlength="120" value="${esc(option.label??'')}" placeholder="A short name for this approach"></label><label>Description<textarea data-description required maxlength="4000" rows="3">${esc(option.description??'')}</textarea></label><details><summary>Consequences <span class="muted">optional</span></summary><div class="create-consequences">${['benefit','cost','risk','follow-up'].map(kind=>`<label>${{benefit:'Benefit',cost:'Cost',risk:'Risk','follow-up':'Follow-up'}[kind]}<textarea data-consequence="${kind}" maxlength="4000" rows="2">${esc(option.consequences?.filter(c=>c.kind===kind).map(c=>c.text).join('\n')??'')}</textarea></label>`).join('')}</div></details>`;
+    row.querySelector('[data-remove]').onclick=()=>{if($('create-options').children.length>2){row.remove();numberOptions();keep();}};
+    for(const field of row.querySelectorAll('input,textarea'))field.oninput=keep;
+    return row;
+  }
+  function numberOptions(){for(const [i,row] of [...$('create-options').children].entries()){row.querySelector('h3').textContent=`Alternative ${i+1}`;row.querySelector('[data-remove]').disabled=$('create-options').children.length<=2;} $('create-option-add').disabled=$('create-options').children.length>=12;}
+  function setOptions(options=[{},{}]){$('create-options').replaceChildren(...options.map(optionRow));numberOptions();}
+  $('create-option-add').onclick=()=>{if($('create-options').children.length<12){const row=optionRow();$('create-options').append(row);numberOptions();keep();row.querySelector('input').focus();}};
+  $('create-severity').onchange=keep;
+  function keep(){try{localStorage.setItem(key(),JSON.stringify({form:form(),review,request,at:Date.now()}));return true;}catch{feedback('This new document draft could not be preserved locally. Keep this dialog open or copy its content.',true);return false;}}
+  function feedback(message,error=false){$('create-feedback').textContent=message;$('create-feedback').classList.toggle('error',error);}
+  function chooseTemplate(){
+    const selected=catalog.templates.find(t=>t.name===$('create-template').value);if(!selected)return;
+    $('create-status').replaceChildren(...selected.statuses.map(status=>new Option(status,status)));
+    $('create-status').value=selected.defaultStatus;$('create-folder').value=selected.folder;
+    const native=selected.native===true;
+    $('create-name-label').textContent=selected.name==='flag'?'Finding':selected.name==='decision'?'Question':'Title';
+    $('create-name').placeholder=native?(selected.name==='flag'?'What did you observe?':'What needs deciding?'):'What is this document about?';
+    $('create-folder').readOnly=native;
+    for(const [id,type] of [['create-flag-fields','flag'],['create-decision-fields','decision']]){const active=selected.name===type;$(id).hidden=!active;for(const input of $(id).querySelectorAll('input,select,textarea'))input.disabled=!active;}
+    if(native&&!$('create-filename').value){$('create-filename').value=crypto.randomUUID()+'.md';filenameEdited=true;}
+    $('create-title').textContent=native?`New ${selected.name}`:'New document';
+    $('create-preview-button').textContent=native?`Preview ${selected.name}`:'Preview document';
+    $('create-origin').textContent=`${selected.origin} · ${selected.description}${selected.note?' '+selected.note:''}`;
+  }
+  function renderReview(){
+    $('create-form').hidden=!!review;$('create-review').hidden=!review;
+    if(!review)return;
+    $('create-path').textContent=review.path;$('create-source').textContent=review.source;
+    // Creation preview has no active document context or privileged link navigation.
+    $('create-preview').innerHTML=review.record?`<p class="record-eyebrow">Open${review.record.type==='flag'?` · ${esc(review.record.record_data.severity)} · Unreviewed`:''}</p><h1>${esc(review.record.finding??review.record.question)}</h1>${nativeContent({data:review.record.record_data})}${markdownHtml(splitSource(review.source).body)}`:markdownHtml(review.source);
+    $('create-setup').hidden=!review.setup;$('create-setup-source').textContent=review.setup?.source??'';
+    $('create-diagnostics').replaceChildren(...(review.diagnostics??[]).map(d=>{const row=document.createElement('li');row.textContent=`${d.level}: ${d.message}`;return row;}));
+    $('create-confirm').textContent=review.state==='committed'?(review.record?'Open created record':'Open created document'):review.state==='prepared'?'Retry reviewed creation':review.record?`Create ${review.record.type}`:'Create document';
+    $('create-back').disabled=review.state!=='reviewed';$('create-discard').disabled=review.state!=='reviewed';
+    $('create-confirm').disabled=review.state==='discarded'||review.state==='prepared'&&review.currentRevision!=null&&review.currentRevision!==review.revision;
+  }
+  async function show({operationId,template}={}) {
+    if(state.busy)throw new Error('Wait for the current operation before creating a record.');
+    const own=++sequence,owner=checkout();await beforeNavigate();const result=await api('create');if(own!==sequence||owner!==checkout())return;catalog=result;scope=owner;
+    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();
+    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;}
+    }catch{feedback('A local new-document draft could not be read. Its stored entry has been kept.',true);}
+    if(operationId||review?.operationId){const inspected=await api('create/inspect',{operationId:operationId??review.operationId});if(own!==sequence||owner!==checkout())return;review=inspected;if(!review)feedback('No creation review was found. Your form is retained; preview it again.',true);}
+    if(template&&template!==$('create-template').value){if(review||$('create-name').value)feedback('Your retained creation draft is open. Finish or discard it before starting another record.');else{$('create-template').value=template;chooseTemplate();}}
+    if(operationId&&review?.record&&!request){$('create-template').value=review.record.type;chooseTemplate();$('create-name').value=review.record.finding??review.record.question;$('create-body').value=splitSource(review.source).body;$('create-folder').value=review.path.slice(0,review.path.lastIndexOf('/'));$('create-filename').value=review.path.split('/').at(-1);if(review.record.type==='flag')$('create-severity').value=review.record.record_data.severity;else setOptions(review.record.record_data.options);}
+    $('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-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();};
+  for(const id of ['create-status','create-folder','create-body'])$(id).oninput=keep;
+  async function busy(work){if(state.busy)return;if(scope!==checkout()){feedback('The checkout changed. Resume this creation in its original checkout.',true);return;}state.busy=true;$('create-close').disabled=true;for(const button of dialog.querySelectorAll('button'))button.disabled=true;try{await work();}catch(error){feedback(error.message,true);if(error.details?.diagnostics)$('create-diagnostics').replaceChildren(...error.details.diagnostics.map(d=>{const li=document.createElement('li');li.textContent=d.message;return li;}));notice(error.message,true);}finally{state.busy=false;for(const button of dialog.querySelectorAll('button'))button.disabled=false;$('create-preview-button').disabled=!catalog?.templates.length;numberOptions();renderReview();if(scope!==checkout())dialog.close();}}
+  $('create-form').onsubmit=event=>{event.preventDefault();return busy(async()=>{$('create-diagnostics').replaceChildren();const fields=form(),{operationId,...previous}=request??{};request={...fields,operationId:operationId&&JSON.stringify(previous)===JSON.stringify(fields)?operationId:crypto.randomUUID()};if(!keep())throw new Error('Preserve the new document draft before reviewing it.');const result=await api('create/preview',request);current();review=result;keep();renderReview();feedback(`Review the new file, then choose ${$('create-confirm').textContent}.`);$('create-confirm').focus();});};
+  $('create-back').onclick=()=>busy(async()=>{if(review)await api('create/discard',{operationId:review.operationId});current();review=null;request=null;keep();renderReview();$('create-name').focus();});
+  $('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.');
+  });
+  $('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();}};
+  dialog.addEventListener('cancel',event=>{if(state.busy||!keep())event.preventDefault();});
+  document.addEventListener('keydown',event=>{if(dialog.open&&(event.metaKey||event.ctrlKey)&&event.key.toLowerCase()==='s'){event.preventDefault();if(!state.busy){if(review)$('create-confirm').focus();else $('create-form').requestSubmit();}}});
+  $('new-document').onclick=()=>show().catch(error=>notice(error.message,true));
+  return {show};
+}

package/assets/app/document-lifecycle.mjs

@@ -0,0 +1,36 @@
+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 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();
+ const label=document.createElement('p');label.className='muted';label.textContent=`Current status: ${info.current}. Status changes use the CLI’s lifecycle rules, including moves, reference repairs and history.`;root.append(label);
+ const form=document.createElement('form');form.id='lifecycle-form';form.innerHTML='<label>New status<select id="lifecycle-status"></select></label><label>Reason<textarea id="lifecycle-note" required rows="3" maxlength="4000" placeholder="What changed and why?"></textarea></label><button id="lifecycle-review-button" class="primary">Review status change</button>';
+ 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;}};
+ 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 acknowledge(result,root,feedback){
+  root.querySelector('#lifecycle-acknowledge')?.remove();
+  if(!result.current)return;
+  const form=document.createElement('form');form.id='lifecycle-acknowledge';
+  form.innerHTML='<label>What did you verify?<textarea required maxlength="4000" rows="3" placeholder="Describe the source and CLI transactions you inspected."></textarea></label><p class="muted">Acknowledge this interrupted review after inspecting its source and CLI transactions. Its outcome stays marked uncertain; this will not replay the operation.</p><button class="quiet">Acknowledge inspected outcome</button>';
+  root.append(form);form.onsubmit=async event=>{event.preventDefault();if(state.busy)return;state.busy=true;const button=form.querySelector('button');button.disabled=true;$('lifecycle-close').disabled=true;
+   try{const settled=await api('lifecycle/settle',{operationId:pending.operationId,expectedRevision:result.current.revision,note:form.querySelector('textarea').value});localStorage.removeItem(key(pending.path));pending=null;state.busy=false;dialog.close();await open(settled.current.path);notice('Interrupted review acknowledged without replay. Its recorded outcome remains uncertain.');}
+   catch(error){feedback.textContent=error.message;}
+   finally{state.busy=false;button.disabled=false;$('lifecycle-close').disabled=false;}
+  };
+ }
+ async function resume(operationId){const result=await api('lifecycle/inspect',{operationId});if(!result)throw new Error('The lifecycle operation is unavailable; its recovery entry has been kept.');await open(result.current?.path??result.newPath??result.path);if(result.state==='committed'){notice('The status change was already saved.');return;}localStorage.setItem(key(result.path),JSON.stringify(result));await show();}
+ $('lifecycle-open').onclick=()=>show().catch(error=>notice(error.message,true));$('lifecycle-close').onclick=()=>{if(!state.busy)dialog.close();};dialog.addEventListener('cancel',e=>{if(state.busy)e.preventDefault();});return {resolveInitial,resume};
+}

package/assets/app/document-stages.mjs

@@ -0,0 +1,22 @@
+import { readSourceStage } from './shared.mjs';
+
+// Stage is authored metadata. A choice only changes the existing editor draft;
+// the ordinary source review/save flow publishes it with its usual guards.
+export function documentStages({state,$,changed}) {
+  const select=$('document-stage'),meaning=$('document-stage-meaning');
+  let current={word:null,invalid:false};
+  select.onchange=()=>changed(select.value?select.value.slice(5):null);
+  return {update(source) {
+    const plan=state.doc?.kind==='plan';$('document-stage-fields').hidden=!plan;
+    if(!plan)return;
+    current=readSourceStage(source);
+    const definitions=state.doc.stageDefinitions??[],known=definitions.some(stage=>stage.word===current.word);
+    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.');
+  }};
+}

package/assets/app/document-views.mjs

@@ -0,0 +1,33 @@
+const panels = {read:'reading', edit:'editing', review:'reviewing', source:'source-view'};
+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}) {
+  $('document-tabs').addEventListener('keydown', event => {
+    const current = modes.findIndex(mode => event.target === $('tab-' + mode));
+    if (current < 0) return;
+    let next;
+    if (event.key === 'ArrowRight') next = (current + 1) % modes.length;
+    else if (event.key === 'ArrowLeft') next = (current + modes.length - 1) % modes.length;
+    else if (event.key === 'Home') next = 0;
+    else if (event.key === 'End') next = modes.length - 1;
+    else return;
+    event.preventDefault();
+    // Read-only documents disable editing; skip unavailable tabs in order.
+    const step = event.key === 'ArrowLeft' || event.key === 'End' ? -1 : 1;
+    for (let tried = 0; tried < modes.length; tried++) {
+      const tab = $('tab-' + modes[next]);
+      if (!tab.disabled) { view(modes[next]); tab.focus(); return; }
+      next = (next + step + modes.length) % modes.length;
+    }
+  });
+  return {update(mode) {
+    for (const name of modes) {
+      const selected = name === mode, tab = $('tab-' + name);
+      tab.setAttribute('aria-selected', String(selected));
+      tab.tabIndex = selected ? 0 : -1;
+      $(panels[name]).hidden = !selected;
+    }
+  }};
+}

package/assets/app/document-yardstick.mjs

@@ -0,0 +1,258 @@
+// Saved Markdown and explicit human choices; no inferred ranking or assessment.
+export function documentYardstick({ state, $, api, checkout, open, library, notice }) {
+  const panel = $('yardstick-panel');
+  let info = null, pending = null, working = false, sequence = 0, dialog = null, activePath = null;
+  const labels = { serves: 'Serves the goal', clear: 'Clear assessment', fold: 'Fold into another plan', close: 'Close plan' };
+  const isPlan = () => state.doc?.type ? state.doc.type === 'plan' : state.doc?.kind === 'plan';
+  const excerpt = (text, limit = 2000) => text?.length > limit
+    ? `${text.slice(0, limit).trimEnd()}… [shortened; read the source for the full text]` : text;
+  const key = path => `runlist:yardstick:${checkout()}:${encodeURIComponent(path)}`;
+  const node = (tag, text, className) => { const element = document.createElement(tag); if (text !== undefined) element.textContent = text; if (className) element.className = className; return element; };
+  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:yardstick:${checkout()}:`)) {
+          const value = JSON.parse(localStorage.getItem(location));
+          if (value?.newPath === path) return value;
+        }
+      }
+    } catch { /* Disk receipts remain discoverable in Recovery. */ }
+    return null;
+  };
+  const remember = () => {
+    try { localStorage.setItem(key(pending.path), JSON.stringify(pending)); }
+    catch { notice('This review is retained on disk. Reopen it from Recovery if this window closes.', true); }
+  };
+  const forget = path => { try { localStorage.removeItem(key(path)); } catch {} };
+  const blocked = () => state.dirty || state.pending || state.recovery && (state.recovery.source !== state.recovery.baseSource || state.recovery.pending);
+  const unavailable = action => !info?.enabled || !info.actions.includes(action) || blocked() || state.busy || working;
+
+  function update() {
+    if (!panel || !info || activePath !== state.doc?.path) return;
+    const note = panel.querySelector('.yardstick-availability');
+    if (note) note.textContent = blocked() ? 'Save or discard the plan draft before recording an assessment.' : info.reason ?? '';
+    for (const button of panel.querySelectorAll('[data-yardstick-action]')) button.disabled = unavailable(button.dataset.yardstickAction);
+    if (dialog?.open) {
+      const apply = dialog.querySelector('[data-yardstick-apply]');
+      if (apply) apply.disabled = !pending?.comparison || pending.state !== 'reviewed' || unavailable(pending.action);
+    }
+  }
+  function render() {
+    panel.replaceChildren();
+    panel.hidden = !isPlan() || !info?.comparison.goal.enabled;
+    if (panel.hidden) return;
+    const { goal, delivers, assessment } = info.comparison;
+    const details = node('details', undefined, 'yardstick-summary');
+    const assessmentLabel = assessment.issues.length ? 'Assessment needs repair'
+      : ({ serves: 'Serves the goal', folded: 'Folded into another plan', closed: 'Closed' }[assessment.disposition] ?? 'Not reviewed');
+    const summary = node('summary', `Product goal · ${assessmentLabel}`);
+    const goalExcerpt = goal.statement?.length > 2000
+      ? `${goal.statement.slice(0, 2000).trimEnd()}… [shortened; open the goal document for the full text]` : goal.statement;
+    const goalText = node('p', goal.state === 'ready' ? goalExcerpt : `Goal unavailable: ${goal.message}`, 'yardstick-goal');
+    details.append(summary, goalText);
+    if (goal.source) {
+      const source = node('button', `Open goal · ${goal.source}`, 'quiet small'); source.type = 'button';
+      source.onclick = () => { if (state.busy || working) return; open(goal.source).catch(error => notice(error.message, true)); };
+      details.append(source);
+    }
+    details.append(node('h3', 'This saved plan delivers'), node('p', delivers || 'Unset', 'yardstick-delivers'), node('h3', 'Owner assessment'), node('p', assessmentLabel));
+    if (assessment.reason) details.append(node('p', assessment.reason, 'yardstick-reason'));
+    if (assessment.into) {
+      const replacement = node('button', `Replacement · ${assessment.into}`, 'quiet small'); replacement.type = 'button';
+      replacement.onclick = async () => {
+        try { const target = await api(`link?${new URLSearchParams({ ref: assessment.into, from: state.doc.path })}`); if (!target) throw new Error('The replacement plan is unavailable.'); await open(target.path); }
+        catch (error) { notice(error.message, true); }
+      };
+      details.append(replacement);
+    }
+    if (assessment.reviewedEarlierGoal) details.append(node('p', 'Reviewed against an earlier goal. Review it again before keeping this assessment.', 'inline-note'));
+    for (const issue of assessment.issues) details.append(node('p', issue, 'inline-note'));
+    const actions = node('div', undefined, 'yardstick-actions');
+    for (const action of ['serves', 'clear', 'fold', 'close']) {
+      const button = node('button', labels[action], action === 'close' || action === 'fold' ? 'quiet' : 'quiet small');
+      button.type = 'button'; button.dataset.yardstickAction = action;
+      button.onclick = () => show(action).catch(error => notice(error.message, true)); actions.append(button);
+    }
+    const availability = node('p', undefined, 'yardstick-availability inline-note'); availability.setAttribute('role', 'status');
+    details.append(actions, availability); panel.append(details); update();
+  }
+  async function opened() {
+    const path = state.doc?.path, own = ++sequence;
+    info = null; activePath = path;
+    panel.replaceChildren(); panel.hidden = true;
+    if (!isPlan()) return;
+    try {
+      const result = await api(`yardstick?path=${encodeURIComponent(path)}`);
+      if (own !== sequence || state.doc?.path !== path) return;
+      info = result; render();
+    } catch (error) { if (own === sequence) notice(`Product goal unavailable. ${error.message}`, true); }
+  }
+  function makeDialog() {
+    if (dialog) return dialog;
+    dialog = node('dialog', undefined, 'yardstick-dialog'); dialog.id = 'yardstick-dialog';
+    dialog.setAttribute('aria-labelledby', 'yardstick-dialog-title'); document.body.append(dialog);
+    dialog.addEventListener('cancel', event => { if (working) event.preventDefault(); });
+    return dialog;
+  }
+  function closeDialog() { if (!working) dialog.close(); }
+  function dialogShell(title) {
+    const root = makeDialog(); root.replaceChildren();
+    const heading = node('h2', title); heading.id = 'yardstick-dialog-title';
+    const close = node('button', 'Close', 'quiet'); close.type = 'button'; close.dataset.yardstickDismiss = ''; close.onclick = closeDialog;
+    const header = node('div', undefined, 'dialog-header'); header.append(heading, close);
+    root.append(header, node('p', `${state.doc.title} · ${state.doc.path}`, 'muted'));
+    return root;
+  }
+  async function busyRun(task) {
+    working = true; state.busy = true; update();
+    for (const button of dialog.querySelectorAll('button')) button.disabled = true;
+    try { return await task(); }
+    finally { working = false; state.busy = false; for (const button of dialog.querySelectorAll('button')) button.disabled = false; update(); }
+  }
+  async function show(action, saved = null) {
+    if (state.busy || working || !state.doc) return;
+    if (saved) { pending = saved; renderReview(); dialog.showModal(); return; }
+    if (unavailable(action)) return;
+    pending = retained(state.doc.path);
+    if (pending) { renderReview(); dialog.showModal(); return; }
+    form(action); dialog.showModal(); dialog.querySelector('textarea')?.focus();
+  }
+  function form(action, previous = {}) {
+    const root = dialogShell(labels[action]), form = node('form'); form.className = 'yardstick-form';
+    const description = node('p', action === 'clear' ? 'Clear the owner assessment. An archived plan stays archived; execution status is unchanged.'
+      : action === 'serves' ? 'Record your assessment that this plan serves the product goal. Execution status is unchanged.'
+      : action === 'fold' ? 'Archive this plan and link it to an existing replacement plan. Review the move and reference repairs before applying.'
+      : 'Archive this plan with your reason. Review the move and reference repairs before applying.', 'muted');
+    const reasonLabel = node('label', action === 'serves' || action === 'clear' ? 'Owner reason (optional)' : 'Owner reason');
+    const reason = node('textarea'); reason.rows = 3; reason.maxLength = 4000; reason.required = action === 'fold' || action === 'close'; reason.value = previous.reason ?? ''; reasonLabel.append(reason);
+    form.append(description);
+    if (action !== 'clear') form.append(reasonLabel);
+    let into = null;
+    if (action === 'fold') {
+      const searchLabel = node('label', 'Find replacement plan'), query = node('input'); query.type = 'search'; query.maxLength = 300; searchLabel.append(query);
+      const find = node('button', 'Find plans', 'quiet'); find.type = 'button';
+      const targetLabel = node('label', 'Replacement plan'), select = node('select'); select.required = true;
+      select.add(new Option('Choose a plan', '')); targetLabel.append(select); form.append(searchLabel, find, targetLabel);
+      if (previous.into) select.add(new Option(previous.into, previous.into)); select.value = previous.into ?? '';
+      let searchSequence = 0;
+      find.onclick = async () => {
+        const own = ++searchSequence; find.disabled = true;
+        try {
+          const result = await api(`library?${new URLSearchParams({ kind: 'plans', q: query.value, limit: '50', archived: '1' })}`);
+          if (own !== searchSequence || !dialog.open) return;
+          select.replaceChildren(new Option('Choose a plan', ''), ...result.documents.filter(doc => doc.path !== state.doc.path && doc.type === 'plan').map(doc => new Option(`${doc.title} · ${doc.path}`, doc.path)));
+          feedback.textContent = result.hasMore ? 'Showing 50 matching plans. Narrow the search to find another.' : result.documents.length ? '' : 'No plans matched this search.';
+        } catch (error) { feedback.textContent = error.message; }
+        finally { if (own === searchSequence) find.disabled = false; }
+      };
+      into = select;
+    }
+    const review = node('button', 'Review assessment', 'primary'); review.type = 'submit';
+    const feedback = node('p', undefined, 'inline-note'); feedback.setAttribute('role', 'status'); form.append(review, feedback); root.append(form);
+    form.onsubmit = async event => {
+      event.preventDefault(); if (unavailable(action)) return;
+      const request = { path: state.doc.path, action, expectedRevision: state.doc.revision, operationId: crypto.randomUUID(),
+        ...(reason.value.trim() ? { reason: reason.value.trim() } : {}), ...(into ? { into: into.value } : {}) };
+      pending = { ...request, newPath: request.path, state: 'preparing', report: 'Review not yet received.' }; remember();
+      try {
+        await busyRun(async () => { const result = await api('yardstick/preview', request); pending = { ...pending, ...result }; remember(); renderReview(); });
+        dialog.querySelector('[data-yardstick-apply]')?.focus();
+      }
+      catch (error) { renderReview(); dialog.querySelector('.yardstick-feedback').textContent = `${error.message} Inspect the retained review or return to the form.`; notice(error.message, true); }
+    };
+  }
+  function renderReview() {
+    const root = dialogShell(labels[pending.action] ?? 'Yardstick assessment');
+    if (pending.comparison) {
+      const { goal, delivers, assessment } = pending.comparison;
+      const reviewed = node('section', undefined, 'yardstick-reviewed-comparison');
+      reviewed.append(node('h3', 'Product goal for this review'), node('p', goal.state === 'ready' ? excerpt(goal.statement)
+        : goal.enabled ? `Goal unavailable: ${goal.message}` : 'Not configured', 'yardstick-reviewed-goal'));
+      if (goal.source) reviewed.append(node('p', `Goal source · ${goal.source}`, 'muted'));
+      reviewed.append(node('h3', 'This saved plan delivers'), node('p', excerpt(delivers, 1000) || 'Unset', 'yardstick-reviewed-delivers'),
+        node('h3', 'Assessment to record'), node('p', pending.action === 'clear' ? 'Clear the assessment; execution status is unchanged.'
+          : ({ serves: 'Serves the goal', folded: 'Folded into another plan', closed: 'Closed' }[assessment.disposition] ?? 'Not reviewed'), 'yardstick-reviewed-assessment'));
+      root.append(reviewed);
+    } else root.append(node('p', 'The prepared comparison is unavailable. Return to the form and review again before applying.', 'inline-note'));
+    const report = node('pre', pending.report ?? 'Review not yet received.', 'lifecycle-report');
+    const feedback = node('p', undefined, 'yardstick-feedback inline-note'); feedback.setAttribute('role', 'status');
+    const apply = node('button', pending.action === 'fold' ? 'Archive and fold plan' : pending.action === 'close' ? 'Archive and close plan' : 'Apply assessment', 'primary');
+    apply.type = 'button'; apply.dataset.yardstickApply = '';
+    const back = node('button', 'Back to form', 'quiet'); back.type = 'button';
+    const inspect = node('button', 'Inspect operation', 'quiet'); inspect.type = 'button';
+    root.append(report, apply, back, inspect, feedback);
+    back.onclick = () => {
+      if (working) return;
+      if (pending.state === 'running') { feedback.textContent = 'Inspect this interrupted operation before starting another review.'; return; }
+      const prior = pending; forget(prior.path); pending = null; form(prior.action, prior); update();
+    };
+    inspect.onclick = async () => {
+      if (working) return;
+      try {
+        await busyRun(async () => {
+          const result = await api('yardstick/inspect', { operationId: pending.operationId });
+          if (!result) { pending.state = 'missing'; feedback.textContent = 'No review was retained. Return to the form and review again.'; return; }
+          pending = { ...pending, ...result }; remember(); report.textContent = result.report;
+          feedback.textContent = `Operation is ${result.state}.${result.failure ? ` ${result.failure.message}` : ''}`;
+          if (result.state === 'committed') {
+            const old = pending.path, destination = result.newPath; forget(old); pending = null;
+            library.relocated(old, destination); dialog.close(); working = false; state.busy = false;
+            await open(destination); await library.load({ refresh: true }); notice('This assessment was already saved.');
+          } else if (result.state === 'running') {
+            feedback.textContent += ' Inspect the source and CLI transactions before starting another change.';
+            if (result.canAcknowledge && result.current) acknowledgement(result, root, feedback);
+          }
+        });
+      } catch (error) { feedback.textContent = error.message; }
+    };
+    apply.onclick = async () => {
+      if (!pending?.comparison || pending.state !== 'reviewed' || unavailable(pending.action)) return;
+      try {
+        await busyRun(async () => {
+          const result = await api('yardstick/commit', { operationId: pending.operationId });
+          const old = pending.path; library.relocated(old, result.newPath); forget(old); pending = null; dialog.close();
+          working = false; state.busy = false; await open(result.newPath); await library.load({ refresh: true });
+          notice('Owner assessment saved. The Markdown source follows the CLI rules.');
+        });
+      } catch (error) { if (pending) { pending.state = 'uncertain'; remember(); } feedback.textContent = `${error.message} Inspect the retained operation before retrying.`; notice(feedback.textContent, true); }
+    };
+    update();
+  }
+  function acknowledgement(result, root, feedback) {
+    root.querySelector('.yardstick-acknowledgement')?.remove();
+    const form = node('form', undefined, 'yardstick-acknowledgement'), label = node('label', 'What did you verify?');
+    const note = node('textarea'); note.required = true; note.maxLength = 4000; note.rows = 3; label.append(note);
+    form.append(label, node('p', 'Acknowledge the inspected outcome without replaying the operation. It remains marked uncertain.', 'muted'));
+    const submit = node('button', 'Acknowledge inspected outcome', 'quiet'); submit.type = 'submit'; form.append(submit); root.append(form);
+    form.onsubmit = async event => {
+      event.preventDefault(); if (working) return;
+      try {
+        await busyRun(async () => {
+          const settled = await api('yardstick/settle', { operationId: pending.operationId, expectedRevision: result.current.revision, note: note.value });
+          forget(pending.path); pending = null; dialog.close(); working = false; state.busy = false;
+          await open(settled.current.path); notice('Interrupted assessment acknowledged without replay.');
+        });
+      } catch (error) { feedback.textContent = error.message; }
+    };
+  }
+  async function resolveInitial(path) {
+    const old = retained(path);
+    if (!old) return path;
+    const result = await api('yardstick/inspect', { operationId: old.operationId });
+    if (result?.state === 'committed') { library.relocated(old.path, result.newPath); forget(old.path); return result.newPath; }
+    return result?.current?.path ?? path;
+  }
+  async function resume(item) {
+    const operationId = typeof item === 'string' ? item : item.operationId;
+    const result = await api('yardstick/inspect', { operationId });
+    if (!result) throw new Error('The assessment is unavailable; its recovery entry has been kept.');
+    await open(result.current?.path ?? result.newPath ?? result.path);
+    if (result.state === 'committed') { forget(result.path); notice('The owner assessment was already saved.'); return; }
+    pending = result; remember(); await show(result.action, result);
+  }
+  function beforeLeave() { if (working || dialog?.open) throw new Error('Close the current yardstick review before switching folders or quitting.'); }
+  return { opened, update, resolveInitial, resume, beforeLeave, busy: () => working };
+}

package/assets/app/editor-navigation.mjs

@@ -0,0 +1,51 @@
+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); } }
+  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)];
+    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');
+  }
+  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) {
+    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;
+  }
+  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='';}
+    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();
+  }
+  $('section-filter').oninput=render;
+  $('toggle-outline').onclick=()=>{$('evidence').classList.toggle('outline-open');$('section-filter').focus();};
+  $('close-outline').onclick=()=>$('evidence').classList.remove('outline-open');
+  $('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');});
+  $('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);}};
+}