runlist 0.0.0 → 0.94.2

package/assets/app/quick-navigation.mjs

@@ -0,0 +1,52 @@
+import {semanticSearch} from './semantic-search.mjs';
+export function quickNavigation({$,api,state,library,open,jump,actions,notice}) {
+  const dialog=$('quick-dialog');let sequence=0,timer,running=false,rerun=false,items=[],active=0,semantic=null,submitted='',keyboardChosen=false;
+  const mode=()=>$('quick-mode').value;
+  function cancel(){semantic?.abort();semantic=null;submitted='';$('quick-cancel').hidden=true;}
+  function choose(index){active=Math.max(0,Math.min(items.length-1,index));for(const [i,row] of [...$('quick-results').children].entries())row.setAttribute('aria-selected',String(i===active));if(items.length)$('quick-query').setAttribute('aria-activedescendant',`quick-result-${active}`);else $('quick-query').removeAttribute('aria-activedescendant');}
+  function render(results) {
+    keyboardChosen=false;items=results.slice(0,80);$('quick-results').replaceChildren(...items.map((item,index)=>{
+      const row=document.createElement('button');row.id=`quick-result-${index}`;row.className='quick-result quiet';row.setAttribute('role','option');row.tabIndex=-1;
+      const title=document.createElement('strong');title.textContent=item.title;
+      const detail=document.createElement('small');detail.textContent=item.detail??item.path??'';row.append(title,detail);row.onclick=()=>activate(index);return row;
+    }));choose(0);
+  }
+  async function activate(index){if(state.busy)return;const item=items[index];if(!item)return;close();try{if(item.run)await item.run();else{await open(item.path);if(item.line){if(item.revision&&state.doc?.revision!==item.revision)notice('The document changed. Search again to verify its section.',true);else jump(item);}}}catch(error){notice(error.message,true);}}
+  const matchingActions=query=>actions().filter(action=>!query||`${action.title} ${action.detail??''}`.toLowerCase().includes(query)).map(a=>({...a,detail:a.detail??'Action'}));
+  async function semanticQuery(){
+    cancel();const query=$('quick-query').value.trim(),own=++sequence;if(!query){$('quick-status').textContent='Enter a question, then press Search. Uses optional local gmax.';return;}
+    const controller=new AbortController();semantic=controller;$('quick-cancel').hidden=false;render(matchingActions(query.toLowerCase()));$('quick-status').textContent='Searching the existing local gmax index…';
+    try{
+      const result=await semanticSearch(api,{query,archived:$('quick-archived').checked},controller.signal);
+      if(own!==sequence||!dialog.open||query!==$('quick-query').value.trim()||mode()!=='semantic')return;
+      if(result.state!=='ready'){$('quick-status').textContent=result.message??'Semantic search is unavailable. Exact search is available.';return;}
+      render([...matchingActions(query.toLowerCase()),...result.documents.map(doc=>({...doc,detail:`${doc.path} · ${doc.excerpt}${doc.location==='changed'?' · Location changed':''}`})),...result.sections.map(section=>({...section,detail:`Verified section · ${section.path}`}))]);submitted=query;
+      $('quick-status').textContent=`${result.documents.length} top semantic matches${result.coverage.partial?' · Index coverage is incomplete':''}${result.indexUpdating?' · Index is updating':''}${result.stale?' · Changed sources open at the document':''}. Exact search is also available.`;
+    }catch(error){if(own===sequence&&dialog.open&&!controller.signal.aborted)$('quick-status').textContent=error.message;}
+    finally{if(semantic===controller){semantic=null;$('quick-cancel').hidden=true;}}
+  }
+  async function search(){
+    if(!dialog.open)return;if(mode()==='semantic')return semanticQuery();
+    if(running){rerun=true;return;}running=true;
+    const own=++sequence,query=$('quick-query').value.trim();render(matchingActions(query.toLowerCase()));$('quick-status').textContent=query?'Searching local documents…':'Choose an action or recent document.';
+    try{
+      if(!query){render([...matchingActions(''),...(library.quickDocuments?.()??[]).map(doc=>({...doc,detail:`Recent or pinned · ${doc.path}`}))]);return;}
+      const result=await api(`search?${new URLSearchParams({q:query,archived:$('quick-archived').checked?'1':'0',limit:'30'})}`);
+      if(own!==sequence||!dialog.open||query!==$('quick-query').value.trim()||mode()!=='text')return;
+      render([...matchingActions(query.toLowerCase()),...result.documents.map(doc=>({...doc,detail:doc.excerpt?`${doc.path} · ${doc.excerpt}`:doc.path})),...result.sections.map(section=>({...section,detail:`Section · ${section.path}`}))]);
+      $('quick-status').textContent=`${result.total} matching documents · ${result.sections.length} matching sections${result.partial?` · Partial search: scanned ${result.scanned} of ${result.inventoryTotal} documents; narrow the query or folder in the library.`:''}${result.unavailable?` · ${result.unavailable} unavailable files`:''}${!items.length?' · No matches. Try another search.':''}`;
+    }catch(error){if(own===sequence&&dialog.open)$('quick-status').textContent=`Search unavailable. ${error.message}`;}
+    finally{running=false;if(rerun){rerun=false;if(mode()==='text')await search();}}
+  }
+  async function show(){if(state.busy||$('workspace').hidden)return;if(document.querySelector('dialog[open]'))return;dialog.showModal();$('quick-query').value='';$('quick-mode').value='text';modeChanged(false);$('quick-query').focus();await search();}
+  function close(){sequence++;cancel();clearTimeout(timer);dialog.close();$('quick-query').removeAttribute('aria-activedescendant');}
+  function modeChanged(reload=true){sequence++;cancel();clearTimeout(timer);render(matchingActions($('quick-query').value.trim().toLowerCase()));const semanticMode=mode()==='semantic';$('quick-search').hidden=!semanticMode;$('quick-tool-settings').hidden=!semanticMode;$('quick-hint').textContent=semanticMode?'Enter to search, then ↑ ↓ and Enter to open · Esc to close. Experimental semantic search · optional local gmax; existing index only. Text search is available.':'↑ ↓ to choose · Enter to open · Esc to close. Searches local document contents on demand.';$('quick-status').textContent=semanticMode?'Enter a question, then press Search.': 'Choose an action or recent document.';if(reload&&!semanticMode&&dialog.open)void search();}
+  $('quick-mode').onchange=modeChanged;
+  $('quick-query').oninput=()=>{sequence++;cancel();render(matchingActions($('quick-query').value.trim().toLowerCase()));clearTimeout(timer);if(mode()==='semantic')$('quick-status').textContent='Press Enter or Search to query the existing index.';else{$('quick-status').textContent='Searching local documents…';timer=setTimeout(search,200);}};
+  $('quick-archived').onchange=()=>{sequence++;cancel();if(mode()==='text')return search();render(matchingActions($('quick-query').value.trim().toLowerCase()));$('quick-status').textContent='Filters changed. Press Search.';};
+  $('quick-query').onkeydown=event=>{if(['ArrowDown','ArrowUp','Home','End','Enter'].includes(event.key)){event.preventDefault();if(event.key==='Enter'){if(mode()==='semantic'&&submitted!==$('quick-query').value.trim()&&!(keyboardChosen&&items[active]?.run))void semanticQuery();else void activate(active);}else{choose(event.key==='Home'?0:event.key==='End'?items.length-1:active+(event.key==='ArrowDown'?1:-1));keyboardChosen=true;}$('quick-results').children[active]?.scrollIntoView({block:'nearest'});}};
+  $('quick-search').onclick=semanticQuery;$('quick-cancel').onclick=()=>{sequence++;cancel();$('quick-status').textContent='Semantic search cancelled.';};$('quick-tool-settings').onclick=()=>{close();$('open-settings').click();};
+  $('quick-close').onclick=close;dialog.addEventListener('cancel',()=>{sequence++;cancel();clearTimeout(timer);});$('quick-open').onclick=()=>show().catch(error=>notice(error.message,true));
+  document.addEventListener('keydown',event=>{if((event.metaKey||event.ctrlKey)&&event.key.toLowerCase()==='k'){if(document.querySelector('dialog[open]')&&!dialog.open)return;event.preventDefault();if(dialog.open)close();else show().catch(error=>notice(error.message,true));}});
+  return {show,search};
+}

package/assets/app/record-navigation.mjs

@@ -0,0 +1,78 @@
+import {escapeHtml as esc,markdownHtml,diffHtml} from './shared.mjs';
+
+export function decisionContent(body) {
+  const outcomes=[];
+  let narrative=body.replace(/\*\*Recorded outcome:\*\*\s*(Disposition:[\s\S]*?)\s*\*\*Original record:\*\*/g,(_,outcome)=>{outcomes.push(outcome);return '';});
+  narrative=narrative.replace(/^Disposition:[^\r\n]*/gim,outcome=>{outcomes.push(outcome);return '';});
+  const latest=outcomes[0];
+  const format=outcome=>{const m=outcome.match(/^Disposition:\s*(\w+)\s+(\d{4}-\d\d-\d\dT[\d:.]+Z)\. Recorded by ([\s\S]*?) \((human|agent)\)\. (?:Selected answer: ([\s\S]*?)\. )?Reason: ([\s\S]*)\.$/);return m?`<strong>${esc(m[1][0]+m[1].slice(1).toLowerCase())}${m[5]?` · ${esc(m[5])}`:''}</strong><p>${esc(m[6])}</p><small class="muted">${esc(m[3])} · ${esc(m[4])} · ${esc(new Date(m[2]).toLocaleString())}</small>`:esc(outcome);};
+  narrative=narrative.replace(/^(Question|Alternatives|Consequences|Evidence):\s*/gim,'\n\n**$1:** ');
+  return `${latest?`<section class="decision-outcome"><h2>Latest recorded outcome</h2>${format(latest)}</section>`:''}<h2>Decision record</h2><article class="markdown record-body">${markdownHtml(narrative)}</article>${outcomes.length>1?`<details class="decision-history"><summary>Earlier outcomes · ${outcomes.length-1}</summary><ol class="record-history">${outcomes.slice(1).map(o=>`<li>${format(o)}</li>`).join('')}</ol></details>`:''}`;
+}
+
+export function nativeContent(record) {
+  const data=record.data??{},array=value=>Array.isArray(value)?value.filter(v=>v&&typeof v==='object'):[];
+  const provenance=event=>`${esc(event.by?.label??event.by?.id??'')} · ${esc(event.at??'')}`;
+  const options=array(data.options),rulings=array(data.rulings),history=array(data.history),evidence=array(data.evidence);
+  const active=rulings.find(r=>r.id===data.active_ruling_id),resolution=array(data.resolutions).find(r=>r.id===data.active_resolution_id);
+  const outcome=active?`<section class="decision-outcome"><h2>Current ruling</h2><strong>${esc(active.kind==='withdraw'?'Closed · Ruling withdrawn':options.find(o=>o.id===active.option_id)?.label??active.option_id)}</strong><p>${esc(active.reason)}</p><small class="muted">${provenance(active)}</small></section>`:data.hold?`<section class="decision-outcome"><h2>On hold</h2><p>${esc(data.hold.reason)}</p><small class="muted">${provenance(data.hold)}</small></section>`:resolution?`<section class="decision-outcome"><h2>Manual resolution</h2><p>${esc(resolution.reason)}</p><small class="muted">${provenance(resolution)}</small></section>`:'';
+
+  return `${outcome}${record.diagnostics?.length?'<p class="inline-note">This record needs format repair. Open its connected source to inspect it.</p>':''}${options.length?`<h2>Alternatives and consequences</h2><div class="native-options">${options.map(option=>`<section><h3>${esc(option.label)}</h3><p>${esc(option.description)}</p><ul>${array(option.consequences).map(c=>`<li><strong>${esc(c.kind)}</strong>: ${esc(c.text)}</li>`).join('')}</ul></section>`).join('')}</div>`:''}${rulings.length?`<h2>Ruling history</h2><ol class="record-history">${[...rulings].reverse().map(r=>`<li><strong>${esc(r.kind==='withdraw'?'Ruling withdrawn':options.find(o=>o.id===r.option_id)?.label??r.option_id)}</strong><p>${esc(r.reason)}</p><small class="muted">${provenance(r)}</small></li>`).join('')}</ol>`:''}${data.triage?`<h2>Triage</h2><p>${esc(data.triage.disposition)}${data.triage.reason?` · ${esc(data.triage.reason)}`:''}</p><small class="muted">${data.triage.by?provenance(data.triage):''}</small>`:''}${evidence.length?`<h2>Observed evidence</h2>${evidence.map(e=>`<section class="native-evidence"><p>${esc(e.path??e.uri??e.kind)}${e.anchor?.start_line?`:${e.anchor.start_line}`:''}</p><pre>${esc(e.anchor?.quote??e.note??'No quote recorded.')}</pre><small class="muted">${esc(e.revision?.kind==='unknown'?e.revision.reason:e.revision?.value??'')} · ${provenance({by:e.by,at:e.observed_at})}</small></section>`).join('')}`:''}${history.length?`<h2>Record history</h2><ol class="record-history">${[...history].reverse().map(h=>`<li><strong>${esc(h.event??h.kind??'Recorded')}</strong><p>${esc(h.reason??h.note??'')}</p><small class="muted">${provenance(h)}</small></li>`).join('')}</ol>`:''}`;
+}
+
+export function recordNavigation({state,$,api,open,showLibrary,checkout,preferences=()=>({records:'pending'}),notice,create=async()=>{}}) {
+  const root=$('records-home');let kind='flags',selected=null,offset=0,sequence=0,timer,filters={q:'',status:'pending',severity:'',scope:''},pending=null;
+  const title=()=>kind==='flags'?'Flags':'Decisions';
+  const recoveryKey=()=>`runlist:record-action:${checkout()}:${kind}:${selected?.key}`;
+  const url=key=>{const u=new URL(location.href);u.searchParams.set('view',kind);if(key)u.searchParams.set('record',key);else u.searchParams.delete('record');history.replaceState(null,'',u);};
+  const run=fn=>async()=>{try{await fn();}catch(error){notice(error.message,true);}};
+  function deactivate(){for(const k of ['flags','decisions'])$('library-'+k).setAttribute('aria-pressed','false');}
+  function activate(){state.mode='records';$('empty').hidden=true;$('document').hidden=true;root.hidden=false;for(const k of ['flags','decisions'])$('library-'+k).setAttribute('aria-pressed',String(kind===k));for(const k of ['all','hubs','plans','documents'])$('library-'+k).setAttribute('aria-pressed','false');$('doc-title').textContent=title();}
+  function setCounts(counts){for(const k of ['flags','decisions'])$('library-'+k+'-count').textContent=counts[k].toLocaleString();}
+  async function counts(){const result=await api('records?kind=flags&status=pending');setCounts(result.counts);}
+  async function show(next,key){await showLibrary();kind=next;selected=null;offset=0;filters={q:'',status:preferences().records??'pending',severity:'',scope:''};activate();url(key);if(key)await detail(key);else await load();}
+  function shell(){root.innerHTML=`<div class="library-heading"><div><h1>${title()}</h1><p>${kind==='flags'?'Findings to triage, with original evidence and a history of what happened.':'Questions and outcomes across plans and registers, connected to their source.'}</p></div><div class="record-heading-actions"><button id="records-new" class="primary">New ${kind==='flags'?'flag':'decision'}</button><button id="records-refresh" class="quiet small">↻ Refresh</button></div></div><div class="record-controls"><label class="sr-only" for="record-search">Search ${title()}</label><input id="record-search" class="search" type="search" placeholder="Search ID, question, source…" value="${esc(filters.q)}"><label>Status<select id="record-status"><option value="pending">Needs attention</option><option value="">All statuses</option>${(kind==='flags'?['open','closed','resolved']:['open','held','ruled','closed','unknown']).map(s=>`<option value="${s}">${s==='closed'&&kind==='flags'?'Rejected':s[0].toUpperCase()+s.slice(1)}</option>`).join('')}</select></label>${kind==='flags'?'<label>Severity<select id="record-severity"><option value="">All severities</option><option>problem</option><option>warn</option><option>info</option></select></label>':''}<label>Plan or hub<select id="record-scope"><option value="">All sources</option></select></label></div><div class="library-pagination"><span id="record-range" role="status">Loading records…</span><button id="record-previous" class="quiet small">← Previous</button><button id="record-next" class="quiet small">Next →</button></div><nav id="record-results" aria-label="${title()} list" aria-busy="true"></nav><p id="record-unavailable" class="muted"></p>`;
+    $('record-status').value=filters.status;if(kind==='flags')$('record-severity').value=filters.severity;
+    $('record-search').oninput=()=>{filters.q=$('record-search').value;clearTimeout(timer);timer=setTimeout(()=>{offset=0;run(()=>load(false,false))();},180);};
+    for(const [id,key] of [['record-status','status'],['record-severity','severity'],['record-scope','scope']])if($(id))$(id).onchange=()=>{filters[key]=$(id).value;offset=0;run(()=>load(false,false))();};
+    $('records-new').onclick=run(()=>create(kind==='flags'?'flag':'decision'));$('records-refresh').onclick=run(()=>load(true,false));$('record-previous').onclick=run(()=>{offset=Math.max(0,offset-50);return load(false,false);});$('record-next').onclick=run(()=>{offset+=50;return load(false,false);});
+  }
+  async function load(refresh=false,rebuild=true){if(state.busy)throw new Error('Wait for the current save before navigating.');selected=null;pending=null;if(rebuild)shell();activate();url();const own=++sequence;$('record-results').setAttribute('aria-busy','true');$('record-range').textContent='Loading records…';
+    try{const params=new URLSearchParams({kind,...filters,offset:String(offset)});if(refresh)params.set('refresh','1');const result=await api(`records?${params}`);if(own!==sequence||state.mode!=='records'||selected)return;setCounts(result.counts);offset=result.offset;
+      $('record-scope').replaceChildren(new Option('All sources',''),...result.scopes.map(s=>new Option(s.title,s.path)));$('record-scope').value=filters.scope;
+      $('record-range').textContent=result.total?`${offset+1}–${offset+result.records.length} of ${result.total.toLocaleString()}`:'0 records';$('record-previous').disabled=!offset;$('record-next').disabled=!result.hasMore;
+      $('record-results').replaceChildren(...result.records.map(row=>{const b=document.createElement('button');b.className='record-row quiet';b.innerHTML=`<span class="record-row-label"><strong>${esc(row.title||row.id||'Unnamed decision')}</strong><small>${esc(row.path)}${row.line?`:${row.line}`:''}</small></span><span class="record-row-meta"><span class="record-id">${esc(row.id??'No ID')}</span><span class="status-badge">${esc(row.status)}</span>${row.severity?`<span class="severity ${esc(row.severity)}">${esc(row.severity)}</span>`:''}${row.triage==='accepted'?'<small>Accepted</small>':''}</span>`;b.onclick=run(()=>detail(row.key));return b;}));
+      if(!result.records.length)$('record-results').innerHTML='<p class="library-no-results">No records match these filters. Choose All statuses or try another search.</p>';
+      $('record-unavailable').textContent=result.unavailable?`${result.unavailable} unavailable sources. Refresh to retry.`:'';notice(`${title()} ready.`);
+    }catch(error){if(own===sequence&&$('record-range'))$('record-range').textContent='Records unavailable · try Refresh';throw error;}finally{if(own===sequence&&$('record-results'))$('record-results').setAttribute('aria-busy','false');}
+  }
+  function connectionHtml(links){return links.length?`<div class="record-connections">${links.map((link,i)=>`<button class="quiet small" data-connection="${i}" title="${esc(link.path)}">${esc(link.title)} <span class="muted">${esc(link.kind==='hub'?'Hub':link.type??'Doc')}</span></button>`).join('')}</div>`:'<p class="muted">No linked documents were found in this library.</p>';}
+  function historyHtml(history){return history?.length?`<ol class="record-history">${[...history].reverse().map(h=>`<li><strong>${esc(h.event??h.kind??'Recorded')}</strong> <span class="muted">${esc(h.by?.name??h.by?.label??h.by?.id??'')} · ${esc(h.at??'')}</span><p>${esc(h.note??h.reason??'')}</p></li>`).join('')}</ol>`:'<p class="muted">No later actions have been recorded.</p>';}
+  async function detail(key,{allowBusy=false}={}){if(state.busy&&!allowBusy)throw new Error('Wait for the current save before navigating.');const own=++sequence,wantedKind=kind;clearTimeout(timer);notice('Opening record…');const row=await api(`records?${new URLSearchParams({kind,key})}`);if(own!==sequence||kind!==wantedKind||state.mode!=='records')return;selected=row;pending=null;try{pending=JSON.parse(localStorage.getItem(recoveryKey())??'null');}catch{}activate();url(key);renderDetail();window.scrollTo(0,0);notice(pending?'An interrupted review is retained. Retry its exact request or keep it while reloading the record.':`${title()} record ready.`);}
+  function renderDetail(){const r=selected;
+    let content;
+    if(r.native)content=nativeContent(r)+`<article class="markdown record-body">${markdownHtml(r.body)}</article><details class="record-structured"><summary>Structured record details</summary><pre>${esc(JSON.stringify(r.data??{},null,2))}</pre></details>`;
+    else if(kind==='flags')content=`<div class="record-evidence"><section><h2>Original observation</h2><p class="muted">${esc(r.original.file)}${r.original.line?`:${r.original.line}`:''} · ${esc(r.original.at)}</p><pre>${esc(r.original.quote||'File-level finding; no quote was recorded.')}</pre><p class="muted">${esc(r.original.revisionReason)}</p></section><section><h2>Current evidence <span class="status-badge">${esc(r.current.status)}</span></h2><p class="muted">${r.current.line?`Line ${r.current.line}`:'Location unavailable'}</p><pre>${esc(r.current.quote??'Evidence is unavailable or ambiguous.')}</pre><p class="muted">The original observation stays in the record.</p></section></div><h2>History</h2>${historyHtml(r.history)}`;
+    else content=decisionContent(r.body)+`${r.missing?.length?`<p class="inline-note">Record gaps: ${esc(r.missing.join(', '))}. Open the source to fill them in.</p>`:''}${r.blocks?.length?`<h2>Blocking work</h2><ul>${r.blocks.map(b=>`<li>${esc(typeof b==='string'?b:b.text)}${b.doc?` <small class="muted">${esc(b.doc)}:${b.line}</small>`:''}</li>`).join('')}</ul>`:''}${r.peers?.length?`<h2>Related records</h2>${r.peers.map(p=>`<details><summary>${esc(p.id)} · ${esc(p.status)} · ${esc(p.path)}</summary><article class="markdown">${markdownHtml(p.body)}</article></details>`).join('')}`:''}`;
+    root.innerHTML=`<div class="record-back"><button id="records-back" class="quiet small">← ${title()}</button><button id="record-reload" class="quiet small">↻ Reload record</button></div><div class="record-heading"><div class="record-eyebrow">${esc(r.id??'Unnamed decision')} · <span class="status-badge">${esc(r.status)}</span> ${r.severity?`· ${esc(r.severity)}`:''}</div><h1>${esc(r.title)}</h1><p class="muted">${esc(r.path)}${r.line?`:${r.line}`:''}</p></div><section class="record-links"><h2>Connected work</h2>${connectionHtml(r.connections??[])}</section>${content}<section class="record-action"><h2>${kind==='flags'?'Triage this flag':'Record an outcome'}</h2>${r.editable?`<form id="record-action-form"><div class="record-action-fields"><label>${kind==='flags'?'Action':'Disposition'}<select id="record-action">${(kind==='flags'?(r.native&&r.status!=='open'?['reopen']:['accept','reject','resolve']):['held','ruled','closed','open']).map(v=>`<option value="${v}">${v[0].toUpperCase()+v.slice(1)}</option>`).join('')}</select></label><label id="record-choice-label" hidden>Selected answer${r.native&&kind==='decisions'?`<select id="record-choice"><option value="">Choose an existing alternative</option>${(r.data?.options??[]).map(o=>`<option value="${esc(o.id)}">${esc(o.label)}</option>`).join('')}</select>`:'<input id="record-choice" maxlength="4000" placeholder="Which answer was chosen?">'}</label></div><label>Reason<textarea id="record-note" required maxlength="4000" rows="3" placeholder="Why is this the right next step?"></textarea></label><p class="muted">${kind==='flags'?'Accept keeps the flag open. Reject closes it. Resolve records a manual resolution; it does not claim a passing check. Reopen retains earlier history.':'The new outcome is recorded with your identity and date. Previous outcomes and the original record are retained.'}</p><button id="record-review-button" class="primary">Review ${kind==='flags'?'triage':'outcome'}</button></form>`:`<p class="muted">${r.readOnlyReason?esc(r.readOnlyReason):r.native?'Repair the native record diagnostics before recording an action.':kind==='flags'?'This flag has already been closed. Its observation and history are retained.':'This record is read only or has no stable ID. Open its source to inspect or complete it.'}</p>`}<div id="record-review" hidden></div></section>`;
+    $('records-back').onclick=run(()=>load());$('record-reload').onclick=run(async()=>{await api(`records?kind=${kind}&refresh=1`);await detail(r.key);});
+    for(const b of root.querySelectorAll('[data-connection]'))b.onclick=run(()=>open(r.connections[Number(b.dataset.connection)].path));
+    if(r.editable){$('record-action').onchange=()=>{const ruled=$('record-action').value==='ruled';$('record-choice-label').hidden=!ruled;$('record-choice').required=ruled;};$('record-action-form').onsubmit=e=>{e.preventDefault();run(review)();};}
+    if(pending)renderReview();
+  }
+  async function review(){if(state.busy)return;const action=$('record-action').value,note=$('record-note').value,choice=$('record-choice').value;
+    if(selected.native){const preview=await api('native/preview',{path:selected.path,expectedRevision:selected.revision,operationId:crypto.randomUUID(),action,note,optionId:choice});pending={form:{action,note,choice},route:'native/action',request:preview.request,before:preview.before,label:`Record ${action}`,note};}
+    else if(kind==='flags')pending={form:{action,note,choice},route:'flags/triage',request:{key:selected.key,action,note,expectedRevision:selected.revision,operationId:crypto.randomUUID()},label:`${action[0].toUpperCase()+action.slice(1)} ${selected.id}`,note};
+    else {const preview=await api('decisions/preview',{key:selected.key,expectedRevision:selected.revision,disposition:action,note,choice});pending={form:{action,note,choice},route:'save',request:{path:preview.path,source:preview.source,expectedRevision:preview.expectedRevision,operationId:crypto.randomUUID()},before:preview.before,label:`Record ${action} for ${selected.id}`,note};}
+    // Retain exactly the reviewed request before any write, including its UUID.
+    try{localStorage.setItem(recoveryKey(),JSON.stringify(pending));}catch{pending=null;throw new Error('The review could not be retained in local editor storage. Free some storage and try again.');}renderReview();
+  }
+  function renderReview(){if($('record-action-form'))$('record-action-form').hidden=true;$('record-review').hidden=false;$('record-review').innerHTML=`<h3>${esc(pending.label)}</h3><p>${esc(pending.note)}</p>${pending.before?`<div class="diff">${diffHtml(pending.before,pending.request.source)}</div>`:'<p class="muted">This appends a dated action to the flag history. The original evidence is retained.</p>'}<div class="record-review-actions"><button id="record-confirm" class="primary">Confirm ${kind==='flags'?'triage':'outcome'}</button><button id="record-change" class="quiet">Back to form</button></div><p id="record-action-feedback" role="status"></p>`;$('record-confirm').onclick=run(confirm);$('record-change').onclick=()=>{localStorage.removeItem(recoveryKey());const form=pending.form;pending=null;$('record-review').hidden=true;if($('record-action-form')){$('record-action-form').hidden=false;if(form){$('record-action').value=form.action;$('record-note').value=form.note;$('record-choice').value=form.choice;$('record-action').onchange();}}};}
+  async function confirm(){if(state.busy)return;state.busy=true;$('record-confirm').disabled=true;$('record-change').disabled=true;
+    try{await api(pending.route,pending.request);localStorage.removeItem(recoveryKey());pending=null;await counts();await detail(selected.key,{allowBusy:true});notice('Saved. The source and history are available through the CLI.');}
+    catch(error){if($('record-action-feedback'))$('record-action-feedback').textContent=`${error.message} Your reviewed request is retained. Reload the record to inspect it, or retry this exact request.`;throw error;}
+    finally{state.busy=false;if($('record-confirm'))$('record-confirm').disabled=false;if($('record-change'))$('record-change').disabled=false;}
+  }
+  for(const k of ['flags','decisions'])$('library-'+k).onclick=run(()=>show(k));
+  return {show,counts,deactivate};
+}

package/assets/app/recovery-center.mjs

@@ -0,0 +1,53 @@
+export function recoveryCenter({$,api,checkout,beforeNavigate,resume,notice}) {
+  const dialog=$('recovery-dialog');let rows=[],offset=0,hasMore=false,sequence=0;
+  function localItems(){
+    const items=[];let unreadable=0;
+    try { for(let i=0;i<localStorage.length;i++) {
+      const key=localStorage.key(i),prefix=`runlist:recovery:${checkout()}:`,lifecycle=`runlist:lifecycle:${checkout()}:`,record=`runlist:record-action:${checkout()}:`,yardstick=`runlist:yardstick:${checkout()}:`;
+      if(!key.startsWith(prefix)&&!key.startsWith(lifecycle)&&!key.startsWith(record)&&!key.startsWith(yardstick)&&key!==`runlist:create:${checkout()}`)continue;
+      try {
+        const value=JSON.parse(localStorage.getItem(key));if(!value)continue;
+        if(key.startsWith(prefix)&&typeof value.path==='string'&&typeof value.source==='string'&&typeof value.baseSource==='string'&&(value.source!==value.baseSource||value.pending))items.push({kind:'local-draft',path:value.path,location:key,draftId:value.draft?.id,operationId:value.pending?.operationId,at:new Date(value.at).toISOString(),stale:!!value.conflicted,state:value.pending?'interrupted':value.conflicted?'conflict':'draft',available:true});
+        else if(key.startsWith(yardstick))items.push({kind:'yardstick',path:value.path,operationId:value.operationId,at:'',available:true,state:value.state??'retained'});
+        else if(key.startsWith(lifecycle))items.push({kind:'lifecycle',path:value.path,operationId:value.operationId,at:'',available:true,state:'retained'});
+        else if(key.startsWith(record)){const suffix=key.slice(record.length),colon=suffix.indexOf(':');items.push({kind:'record',recordKind:suffix.slice(0,colon),recordKey:suffix.slice(colon+1),path:value.request?.path??'Flag or decision',at:'',available:true,state:'retained'});}
+        else if(key===`runlist:create:${checkout()}`&&(value.form?.title||value.form?.body||value.review))items.push({kind:'creation',operationId:value.review?.operationId,path:value.review?.path??`${value.form?.folder??''}/${value.form?.filename??'New document'}`,state:value.review?.state??'draft',at:new Date(value.at).toISOString(),available:true});
+      }catch{unreadable++;}
+    }
+    } catch {unreadable++;}
+    return {items,unreadable};
+  }
+  const label=row=>row.kind==='git-commit'?`Local Git commit · ${row.state}`:row.kind==='creation'?'New document draft':row.kind==='yardstick'?`Product goal assessment · ${row.state}`:row.kind==='lifecycle'?`Status change · ${row.state}`:row.kind==='record'?'Flag or decision review':row.kind==='operation'?'Interrupted save · inspect outcome':row.operationId||row.pendingOperation?'Interrupted save · draft preserved locally':row.stale?'File changed · compare draft':'Draft preserved locally';
+  function render(){
+    const query=$('recovery-filter').value.toLowerCase(),visible=rows.filter(row=>`${row.path} ${label(row)}`.toLowerCase().includes(query));
+    $('recovery-items').replaceChildren(...visible.map(row=>{
+      const section=document.createElement('section');section.className='recovery-item';
+      const info=document.createElement('div'),title=document.createElement('strong'),detail=document.createElement('p'),date=document.createElement('small');title.textContent=row.path;detail.textContent=label(row);date.textContent=row.at?new Date(row.at).toLocaleString():'';info.append(title,detail,date);
+      const button=document.createElement('button');button.className='quiet';button.textContent=!row.available?'File unavailable':row.kind==='creation'?'Resume creation':row.kind==='git-commit'||row.kind==='yardstick'||row.kind==='lifecycle'||row.kind==='operation'?'Inspect operation':row.kind==='record'?'Resume review':'Resume draft';button.disabled=!row.available;
+      button.onclick=async()=>{try{dialog.close();await resume(row);}catch(error){notice(error.message,true);}};section.append(info,button);return section;
+    }));
+    if(!visible.length){const message=document.createElement('p');message.className='library-no-results';message.textContent=query?'No recovery items match this filter.':'No unfinished work in this checkout.';$('recovery-items').append(message);}
+    $('recovery-more').hidden=!hasMore;
+  }
+  async function load(more=false){
+    const own=++sequence;$('recovery-status').textContent='Reading retained work…';$('recovery-refresh').disabled=true;
+    try {
+      if(!more)offset=0;
+      const result=await api(`recovery?offset=${offset}&limit=50`);if(own!==sequence)return;
+      const local=localItems(),disk=more?rows.filter(row=>row.disk):[];
+      const localDrafts=new Set(local.items.map(row=>row.draftId).filter(Boolean)),localOperations=new Set(local.items.map(row=>row.operationId).filter(Boolean));
+      const diskRows=[...disk,...result.items.map(row=>({...row,disk:true}))];
+      const pendingDrafts=new Set(diskRows.filter(row=>row.kind==='draft').map(row=>row.pendingOperation?.operationId).filter(Boolean));
+      const entries=[...local.items,...diskRows.filter(row=>!localDrafts.has(row.draftId)&&!localOperations.has(row.operationId)&&!(row.kind==='operation'&&pendingDrafts.has(row.operationId)))],seen=new Set();rows=entries.filter(row=>{
+        const key=row.location??(row.operationId?`${row.kind}:${row.operationId}`:row.draftId?`draft:${row.draftId}`:`${row.kind}:${row.path}`);
+        if(seen.has(key))return false;seen.add(key);return true;
+      });
+      rows.sort((a,b)=>String(b.at).localeCompare(String(a.at)));offset=result.offset+result.items.length;hasMore=result.hasMore;render();
+      $('recovery-status').textContent=`${rows.length} items shown${hasMore?' · More retained items available':''}${result.unavailable||local.unreadable?` · ${result.unavailable+local.unreadable} entries need manual inspection; their stored data was kept.`:''}`;
+    }catch(error){$('recovery-status').textContent=`Recovery unavailable. ${error.message} Retained data has been kept.`;}
+    finally{if(own===sequence)$('recovery-refresh').disabled=false;}
+  }
+  async function show(){await beforeNavigate();$('recovery-filter').value='';dialog.showModal();$('recovery-filter').focus();await load();}
+  $('open-recovery').onclick=()=>show().catch(error=>notice(error.message,true));$('recovery-close').onclick=()=>dialog.close();$('recovery-refresh').onclick=()=>load();$('recovery-more').onclick=()=>load(true);$('recovery-filter').oninput=render;
+  return {show,load};
+}

package/assets/app/semantic-search.mjs

@@ -0,0 +1,14 @@
+// Background jobs keep the native helper responsive to Cancel and navigation.
+export async function semanticSearch(api,body,signal){
+  let id,complete=false;
+  try{
+    signal.throwIfAborted();const job=await api('semantic/start',body);id=job.id;
+    if(typeof id!=='string')throw new Error('Semantic search returned an invalid request.');
+    for(let i=0;i<80;i++){
+      signal.throwIfAborted();const result=await api(`semantic/result?${new URLSearchParams({id})}`);signal.throwIfAborted();
+      if(result.state!=='running'){complete=true;return result;}
+      await new Promise((resolve,reject)=>{const abort=()=>{clearTimeout(timer);reject(new Error('Cancelled'));};const timer=setTimeout(()=>{signal.removeEventListener('abort',abort);resolve();},150);signal.addEventListener('abort',abort,{once:true});});
+    }
+    throw new Error('Semantic search timed out. Exact search is available.');
+  }finally{if(id&&!complete)await api('semantic/cancel',{id}).catch(()=>{});}
+}

package/assets/app/settings.mjs

@@ -0,0 +1,15 @@
+import {desktop} from './transport.mjs';
+import {escapeHtml as esc} from './shared.mjs';
+export function appSettings({$,api,checkout,library,notice}){
+ const key=()=>`runlist:preferences:${checkout()}`;
+ const defaults={sort:'updated',archived:false,records:'pending'};
+ const read=()=>{try{const p=JSON.parse(localStorage.getItem(key())??'{}');return {sort:['updated','title','path'].includes(p.sort)?p.sort:'updated',archived:p.archived===true,records:p.records===''?'':'pending'};}catch{return {...defaults};}};
+ async function show(){const info=await api('settings'),tool=await api('semantic/settings'),prefs=read();$('settings-checkout').textContent=info.checkout;$('settings-content').innerHTML=`<section class="settings-section"><h3>${desktop?'This computer':'This browser'}</h3><p class="muted">These preferences stay ${desktop?'in Runlist on this computer':'in this browser'}. They apply when you open this checkout.</p><form id="settings-preferences"><div class="settings-fields"><label>Appearance<select id="settings-theme"><option value="system">System</option><option value="light">Light</option><option value="dark">Dark</option></select></label><label>Default document order<select id="settings-sort"><option value="updated">Recently updated</option><option value="title">Title</option><option value="path">File path</option></select></label><label>Default records view<select id="settings-records"><option value="pending">Needs attention</option><option value="">All statuses</option></select></label><label class="settings-check"><input id="settings-archived" type="checkbox"> Include archived documents by default</label></div><button class="primary">Save preferences</button><span id="settings-feedback" role="status"></span></form></section><section class="settings-section"><h3>Semantic search · experimental</h3><p class="muted">${esc(tool.message)} No gmax dependency is bundled with Runlist. Leave both paths blank to use automatic discovery.</p><form id="settings-semantic"><div class="settings-fields"><label>External Node executable<input id="settings-semantic-node" autocomplete="off" placeholder="Absolute path to node"></label><label>gmax entry file<input id="settings-semantic-entry" autocomplete="off" placeholder="Absolute path to grepmax/dist/bin.js"></label></div><button class="quiet">Save tool paths</button><span id="settings-semantic-feedback" role="status"></span></form></section><section class="settings-section"><h3>Templates</h3><p class="muted">View, customize and review the scaffolds for new documents. Saved templates are repository files and can be shared through Git.</p><button id="settings-templates" class="quiet">Open templates</button></section><section class="settings-section"><h3>Checkout rules</h3><p class="muted">Loaded from ${esc(info.configFile??'built-in defaults')}. Edit repository configuration through the CLI or its source; this view shows the effective rules.</p><dl class="settings-paths"><dt>Document roots</dt><dd>${info.roots.map(p=>`<code>${esc(p)}</code>`).join(' ')}</dd><dt>Excluded folders</dt><dd>${info.exclusions.map(p=>`<code>${esc(p)}</code>`).join(' ')}</dd></dl>${info.statuses.typeOrder.map(type=>`<details class="settings-rules"><summary>${esc(type)} · ${info.statuses.byType[type].length} statuses</summary><div class="settings-table"><table><thead><tr><th>Status</th><th>Context</th><th>Behavior</th></tr></thead><tbody>${info.statuses.byType[type].map(s=>`<tr><td>${esc(s.name)}</td><td>${esc(s.context)}</td><td>${esc([s.startable?'Can start':null,s.terminal?'Terminal':null,s.archive?'Archives':null,s.filed?`Files in ${s.filed}`:null,s.staleDays?`Stale after ${s.staleDays} days`:null].filter(Boolean).join(' · ')||'Ordinary')}</td></tr>`).join('')}</tbody></table></div></details>`).join('')}</section><section class="settings-section"><h3>Where changes live</h3><dl class="settings-paths">${Object.entries(info.sharing).map(([name,value])=>`<dt>${esc(name)}</dt><dd>${esc(value)}</dd>`).join('')}</dl></section>`;
+ $('settings-semantic-node').value=tool.nodePath;$('settings-semantic-entry').value=tool.entryPath;
+ $('settings-semantic').onsubmit=async event=>{event.preventDefault();try{const saved=await api('semantic/settings',{nodePath:$('settings-semantic-node').value.trim(),entryPath:$('settings-semantic-entry').value.trim()});$('settings-semantic-feedback').textContent=saved.message;}catch(error){$('settings-semantic-feedback').textContent=error.message;}};
+ $('settings-theme').value=$('theme-mode').value;$('settings-sort').value=prefs.sort;$('settings-archived').checked=prefs.archived;$('settings-records').value=prefs.records;
+ $('settings-preferences').onsubmit=async event=>{event.preventDefault();try{const preferences={sort:$('settings-sort').value,archived:$('settings-archived').checked,records:$('settings-records').value};localStorage.setItem(key(),JSON.stringify(preferences));$('theme-mode').value=$('settings-theme').value;$('theme-mode').dispatchEvent(new Event('change'));await library.preferences(preferences);$('settings-feedback').textContent='Preferences saved.';}catch(error){notice(error.message,true);$('settings-feedback').textContent='Preferences could not be saved.';}};
+ $('settings-templates').onclick=()=>{$('settings-dialog').close();$('open-templates').click();};$('settings-dialog').showModal();
+ }
+ $('open-settings').onclick=()=>show().catch(error=>notice(error.message,true));$('settings-close').onclick=()=>$('settings-dialog').close();return {read};
+}

package/assets/app/shared.mjs

@@ -0,0 +1,104 @@
+// Pure browser/server helpers. Source is always escaped; authored HTML is text.
+export {readSourceStage, replaceSourceStage, rebaseSourceStage} from './stage-source.mjs';
+export const escapeHtml = value => String(value).replace(/[&<>"']/g, c => ({ '&':'&amp;', '<':'&lt;', '>':'&gt;', '"':'&quot;', "'":'&#39;' }[c]));
+export function splitSource(source) {
+  const envelope = source.match(/^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/)?.[0] ?? '';
+  return { envelope, body: source.slice(envelope.length) };
+}
+export function lineDiff(before, after) {
+  const a = before.replaceAll('\r\n', '\n').split('\n'), b = after.replaceAll('\r\n', '\n').split('\n');
+  let first = 0, lastA = a.length, lastB = b.length;
+  const result = [];
+  while (first < lastA && first < lastB && a[first] === b[first]) result.push({ kind:'same', text:a[first], oldIndex:first++ });
+  while (lastA > first && lastB > first && a[lastA - 1] === b[lastB - 1]) { lastA--; lastB--; }
+  const n = lastA - first, m = lastB - first;
+  if (n * m > 1_000_000) throw new Error('This diff is too large to review safely. Make a smaller edit or review it through the CLI.');
+  const rows = Array.from({ length:n + 1 }, () => new Uint32Array(m + 1));
+  for (let i = n - 1; i >= 0; i--) for (let j = m - 1; j >= 0; j--) rows[i][j] = a[first + i] === b[first + j] ? rows[i + 1][j + 1] + 1 : Math.max(rows[i + 1][j], rows[i][j + 1]);
+  let i = 0, j = 0;
+  while (i < n || j < m) {
+    if (i < n && j < m && a[first + i] === b[first + j]) { result.push({ kind:'same', text:a[first + i], oldIndex:first + i }); i++; j++; }
+    else if (j < m && (i === n || rows[i][j + 1] > rows[i + 1][j])) result.push({ kind:'add', text:b[first + j++] });
+    else { result.push({ kind:'remove', text:a[first + i], oldIndex:first + i }); i++; }
+  }
+  while (lastA < a.length) { result.push({ kind:'same', text:a[lastA], oldIndex:lastA }); lastA++; }
+  return result;
+}
+// Textareas normalize line endings. Reuse exact raw lines for every unchanged
+// line so an edit does not normalize unrelated CRLF or mixed-ending content.
+export function editedSource(base, body) {
+  const parts = splitSource(base), lines = parts.body.split('\n');
+  const eol = parts.body.includes('\r\n') || parts.envelope.includes('\r\n') ? '\r' : '';
+  const diff = lineDiff(parts.body, body);
+  const retained = diff.filter(row => row.kind !== 'remove');
+  return parts.envelope + retained.map((row, i) => row.kind === 'same' ? (i === retained.length - 1 && row.oldIndex < lines.length - 1 ? lines[row.oldIndex].replace(/\r$/, '') : lines[row.oldIndex]) : row.text + (i < retained.length - 1 ? eol : '')).join('\n');
+}
+function safeLink(href, resolve) {
+  if (/^(https?:|mailto:)/i.test(href) || /^#[^\s]*$/.test(href)) return href;
+  if (/^(?:[a-z][a-z0-9+.-]*:|\/\/|\\)/i.test(href)) return null;
+  return resolve?.(href) ?? null;
+}
+function inline(text, resolve) {
+  // Tokenize before escaping so authored markup cannot break attributes, and
+  // code spans never run through emphasis/link replacements.
+  const token = /`([^`]+)`|!?\[([^\]]+)\]\(([^\s)]+)\)|\*\*([^*]+)\*\*|\*([^*]+)\*/g;
+  let html = '', cursor = 0;
+  for (const match of text.matchAll(token)) {
+    html += escapeHtml(text.slice(cursor, match.index));
+    if (match[1] !== undefined) html += `<code>${escapeHtml(match[1])}</code>`;
+    else if (match[2] !== undefined) {
+      const href = safeLink(match[3], resolve);
+      html += href ? `<a href="${escapeHtml(href)}" rel="noreferrer">${escapeHtml(match[2])}</a>` : escapeHtml(match[2]);
+    } else if (match[4] !== undefined) html += `<strong>${escapeHtml(match[4])}</strong>`;
+    else html += `<em>${escapeHtml(match[5])}</em>`;
+    cursor = match.index + match[0].length;
+  }
+  return html + escapeHtml(text.slice(cursor));
+}
+export function markdownHtml(source, resolve) {
+  const lines = splitSource(source).body.replaceAll('\r\n', '\n').split('\n');
+  const out = []; let i = 0;
+  const cells = line => line.trim().replace(/^\||\|$/g, '').split('|').map(c => inline(c.trim(), resolve));
+  while (i < lines.length) {
+    const line = lines[i];
+    if (!line.trim()) { i++; continue; }
+    const fence = line.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
+    if (fence) {
+      const code = []; i++;
+      while (i < lines.length && !new RegExp(`^ {0,3}${fence[1][0]}{${fence[1].length},}\\s*$`).test(lines[i])) code.push(lines[i++]);
+      i++; out.push(`<pre><code>${escapeHtml(code.join('\n'))}</code></pre>`); continue;
+    }
+    if (/^\s*<!--/.test(line)) { while (i < lines.length && !lines[i++].includes('-->')) { /* comments are retained in source */ } continue; }
+    const heading = line.match(/^ {0,3}(#{1,6})\s+(.+?)\s*#*$/);
+    if (heading) { out.push(`<h${heading[1].length}>${inline(heading[2], resolve)}</h${heading[1].length}>`); i++; continue; }
+    if (line.includes('|') && /^\s*\|?\s*:?-{3,}/.test(lines[i + 1] ?? '')) {
+      const header = cells(line); i += 2; const rows = [];
+      while (i < lines.length && lines[i].includes('|') && lines[i].trim()) rows.push(`<tr>${cells(lines[i++]).map(c => `<td>${c}</td>`).join('')}</tr>`);
+      out.push(`<div class="table-wrap"><table><thead><tr>${header.map(c => `<th>${c}</th>`).join('')}</tr></thead><tbody>${rows.join('')}</tbody></table></div>`); continue;
+    }
+    if (/^ {0,3}(?:[-*+] |\d+\. )/.test(line)) {
+      const ordered = /^ {0,3}\d+\. /.test(line), items = [];
+      while (i < lines.length && /^ {0,3}(?:[-*+] |\d+\. )/.test(lines[i])) {
+        const value = lines[i++].replace(/^ {0,3}(?:[-*+] |\d+\. )/, ''), task = value.match(/^\[([ xX])\] (.*)/);
+        items.push(task ? `<li class="task"><span aria-label="${task[1] === ' ' ? 'Incomplete' : 'Complete'}">${task[1] === ' ' ? '□' : '✓'}</span><div>${inline(task[2], resolve)}</div></li>` : `<li>${inline(value, resolve)}</li>`);
+      }
+      out.push(`<${ordered ? 'ol' : 'ul'}>${items.join('')}</${ordered ? 'ol' : 'ul'}>`); continue;
+    }
+    if (/^>\s?/.test(line)) { out.push(`<blockquote>${inline(line.replace(/^>\s?/, ''), resolve)}</blockquote>`); i++; continue; }
+    if (/^\s*(?:---+|\*\*\*+)\s*$/.test(line)) { out.push('<hr>'); i++; continue; }
+    const paragraph = [line]; i++;
+    while (i < lines.length && lines[i].trim() && !/^(?: {0,3}(?:#{1,6}\s|[-*+] |\d+\. |`{3,}|~{3,})|>|\s*<!--)/.test(lines[i]) && !(lines[i].includes('|') && /^\s*\|?\s*:?-{3,}/.test(lines[i + 1] ?? ''))) paragraph.push(lines[i++]);
+    out.push(`<p>${inline(paragraph.join('\n'), resolve)}</p>`);
+  }
+  return out.join('\n');
+}
+export function diffHtml(before, after) {
+  const rows = lineDiff(before, after), visible = new Set();
+  rows.forEach((r, i) => { if (r.kind !== 'same') for (let j = Math.max(0, i - 3); j <= Math.min(rows.length - 1, i + 3); j++) visible.add(j); });
+  if (!visible.size) return '<p class="muted">No source changes.</p>';
+  let previous = -2;
+  return [...visible].map(i => {
+    const row = rows[i], gap = i > previous + 1 ? '<div class="diff-gap">···</div>' : ''; previous = i;
+    return gap + `<div class="diff-line ${row.kind}"><span>${row.kind === 'add' ? '+' : row.kind === 'remove' ? '−' : ' '}</span><code>${escapeHtml(row.text) || ' '}</code></div>`;
+  }).join('');
+}

package/assets/app/stage-source.mjs

@@ -0,0 +1,75 @@
+// A stage draft changes only the plan's ships field. Keep all other source bytes.
+function field(source) {
+  const envelope = source.match(/^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/)?.[0];
+  if (!envelope) throw new Error('Stage editing requires document metadata.');
+  const lines = envelope.match(/[^\n]*\n|[^\n]+$/g) ?? [];
+  const matches = lines.map((line, i) => /^ships:/.test(line) ? i : -1).filter(i => i >= 0);
+  if (matches.length > 1) throw new Error('Repair duplicate ships fields before changing the stage.');
+  const start = matches[0] ?? -1;
+  let end = start + 1;
+  const raw = start < 0 ? '' : lines[start].replace(/^ships:[ \t]*/, '').trim();
+  if (start >= 0 && (!raw || /^[>|][-+]?$/.test(raw))) {
+    let indent=null;
+    while (end < lines.length - 1) {
+      if (lines[end].trim() && /^[ \t]/.test(lines[end])) {
+        const current=lines[end].match(/^[ \t]*/)[0].length;
+        if(indent!==null&&current<indent)break;
+        indent??=current;end++;continue;
+      }
+      if (!lines[end].trim()) {
+        let next=end+1;while(next<lines.length-1&&!lines[next].trim())next++;
+        if (/^[ \t]/.test(lines[next]??'')) {end=next;continue;}
+      }
+      break;
+    }
+  }
+  return {envelope, lines, start, end};
+}
+
+export function withoutSourceStage(source) {
+  const {envelope,lines,start,end} = field(source);
+  if (start < 0) return source;
+  return lines.slice(0,start).join('') + lines.slice(end).join('') + source.slice(envelope.length);
+}
+
+export function replaceSourceStage(source, word) {
+  if (word !== null && (typeof word !== 'string' || !word.trim() || /[\r\n\0]/.test(word))) throw new Error('Choose a single stage from this checkout.');
+  const {envelope,lines,start,end} = field(source), newline = lines[0].endsWith('\r\n') ? '\r\n' : '\n';
+  const next = word === null ? '' : `ships: ${JSON.stringify(word)}${newline}`;
+  if (start >= 0) return lines.slice(0,start).join('') + next + lines.slice(end).join('') + source.slice(envelope.length);
+  return lines.slice(0,-1).join('') + next + lines.at(-1) + source.slice(envelope.length);
+}
+
+export function readSourceStage(source) {
+  try {
+    const {lines,start,end} = field(source);
+    if (start < 0) return {word:null,invalid:false};
+    let value = lines[start].replace(/^ships:\s*/, '').trim();
+    if (!value && lines.slice(start+1,end).every(line=>!line.trim()||line.trimStart().startsWith('#'))) return {word:null,invalid:false};
+    if (/^[>|][-+]?$/.test(value)) {
+      const raw = lines.slice(start + 1,end).map(line=>line.replace(/\r?\n$/,''));
+      const indent = raw.find(line=>line.trim())?.match(/^[ \t]*/)[0].length ?? 0;
+      const contents=raw.map(line=>line.trim()?line.slice(indent):'');
+      const keep=value.endsWith('+');
+      if(value.startsWith('|'))value=contents.join('\n');
+      else {value='';let hasContent=false,blank=false;for(const line of contents){if(!line){if(hasContent&&!blank)value+='\n';blank=true;}else{if(hasContent&&!blank)value+=' ';value+=line;hasContent=true;blank=false;}}}
+      if(keep&&!value.endsWith('\n'))value+='\n';
+    } else if (end > start + 1 || value.startsWith('[') || value.startsWith('{')) return {word:null,invalid:true};
+    else if (value.startsWith('"')) {try {value = JSON.parse(value);} catch {return {word:null,invalid:true};}}
+    else if (value.startsWith("'")) {if (!value.endsWith("'")) return {word:null,invalid:true};value = value.slice(1,-1).replaceAll("''", "'");}
+    else if (value === 'true' || value === 'false') return {word:null,invalid:true};
+    const word=typeof value==='string'?value.trim()||null:null;
+    return typeof value === 'string' && !(word && /[\r\n\0]/.test(value)) ? {word,invalid:false} : {word:null,invalid:true};
+  } catch {return {word:null,invalid:true};}
+}
+
+export function rebaseSourceStage(base, draft, current) {
+  // Metadata refreshed by another writer is authoritative except for the
+  // explicitly drafted stage. The resulting change still requires review.
+  const baseStage = field(base), draftStage = field(draft);
+  const bytes = value => value.start < 0 ? '' : value.lines.slice(value.start,value.end).join('');
+  if (bytes(baseStage) === bytes(draftStage)) return current;
+  const {word,invalid} = readSourceStage(draft);
+  if (invalid) throw new Error('Repair the stage draft before merging it.');
+  return replaceSourceStage(current,word);
+}

package/assets/app/template-editor.mjs

@@ -0,0 +1,47 @@
+import { markdownHtml, diffHtml } from './shared.mjs';
+export function templateEditor({api,$,checkout,notice}) {
+  let catalog, selected, busy=false, preview=false;
+  const drafts=new Map();
+  const key=name=>`runlist:template-draft:${checkout()}:${name}`;
+  const current=()=>drafts.get(selected.name);
+  function keep() {if(!selected?.editable)return;try{localStorage.setItem(key(selected.name),JSON.stringify(current()));}catch{feedback('Template draft could not be saved in local editor storage. Keep this dialog open.',true);}}
+  function feedback(text,error=false){$('template-feedback').textContent=text;$('template-feedback').classList.toggle('error',error);}
+  function dirty(){const d=current();return selected?.editable&&(d.source!==d.base||d.reset);}
+  function render() {
+    if(!selected)return;
+    const d=current();$('template-name').textContent=selected.name;$('template-origin').textContent=selected.origin;$('template-description').textContent=selected.description;
+    $('template-config-note').hidden=!selected.configuredSource;$('template-config').hidden=!selected.configuredSource;$('template-config-source').textContent=selected.configuredSource??'';
+    $('template-source').value=d.source;$('template-source').readOnly=!selected.editable;$('template-source').hidden=preview;
+    $('template-preview').hidden=!preview;
+    $('template-preview-tab').disabled=!selected.editable;
+    $('template-edit-tab').setAttribute('aria-pressed',String(!preview));$('template-preview-tab').setAttribute('aria-pressed',String(preview));
+    const example=d.source.replace(/\{\{(title|status|date|body|version)\}\}/g,(_,token)=>({title:'Example document',status:selected.name==='prompt'?'pending':selected.name==='plan'?'planned':'active',date:new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),body:'Authored content goes here.',version:catalog.version})[token]);
+    $('template-preview').innerHTML=markdownHtml(example);
+    $('template-review-button').disabled=!dirty()||busy;$('template-reset').hidden=!selected.editable||(!selected.overridden&&!selected.configuredSource);
+    $('template-discard').disabled=!dirty()||busy;$('template-tokens').hidden=!selected.editable;
+    $('template-review-button').hidden=!selected.editable;$('template-save').hidden=true;$('template-review').hidden=true;
+    $('template-save').disabled=busy;$('template-source').disabled=busy;
+    $('template-reset').disabled=busy;$('close-templates').disabled=busy;
+    for(const button of $('template-list').children){button.classList.toggle('active',button.dataset.name===selected.name);button.disabled=busy;}
+  }
+  function select(template) {
+    selected=template;preview=false;$('template-reload').hidden=true;
+    if(!drafts.has(template.name)){
+      let saved;try{saved=JSON.parse(localStorage.getItem(key(template.name)));}catch{}
+      drafts.set(template.name,saved&&typeof saved.source==='string'&&typeof saved.base==='string'&&('revision'in saved)?saved:{source:template.source,base:template.source,revision:catalog.revision,reset:false});
+    }
+    render();feedback(!template.editable?'JavaScript template · edit this source in runlist.config.mjs.':dirty()?'Your template draft is kept. Review it before saving.':template.configuredSource&&!template.overridden?'The editor contains a Markdown override starter; the JavaScript template stays active until you save.':'Choose Edit Markdown or Preview example.');
+  }
+  function list(){ $('template-list').replaceChildren(...catalog.templates.map(template=>{const button=document.createElement('button');button.className='quiet';button.dataset.name=template.name;button.textContent=template.name;button.onclick=()=>select(template);return button;})); }
+  $('open-templates').onclick=async()=>{try{catalog=await api('templates');list();select(catalog.templates.find(t=>t.name===selected?.name)??catalog.templates.find(t=>t.name==='plan')??catalog.templates[0]);$('template-dialog').showModal();}catch(error){notice(error.message,true);}};
+  $('close-templates').onclick=()=>{$('template-dialog').close();};
+  $('template-dialog').addEventListener('cancel',event=>{if(busy)event.preventDefault();});
+  $('template-source').oninput=()=>{const d=current();d.source=$('template-source').value;d.reset=false;keep();$('template-save').hidden=true;$('template-review').hidden=true;$('template-review-button').disabled=!dirty();feedback('Template draft kept in local editor storage.');};
+  $('template-edit-tab').onclick=()=>{preview=false;render();};$('template-preview-tab').onclick=()=>{preview=true;render();};
+  $('template-review-button').onclick=()=>{const d=current();$('template-diff').innerHTML=diffHtml(d.base,d.source);$('template-review').hidden=false;$('template-review').open=true;$('template-save').hidden=false;$('template-save').disabled=!dirty();feedback(d.reset?'Save will remove the Markdown override and use the original template.':'Review this template before saving it for future documents.');};
+  $('template-reset').onclick=()=>{const d=current();d.source=selected.defaultSource;d.reset=true;keep();render();feedback('Review and save to remove the Markdown override and use the original template.');};
+  $('template-discard').onclick=()=>{drafts.set(selected.name,{source:selected.source,base:selected.source,revision:catalog.revision,reset:false});localStorage.removeItem(key(selected.name));render();feedback('Template draft discarded.');};
+  $('template-reload').onclick=async()=>{try{catalog=await api('templates');const name=selected.name;selected=catalog.templates.find(t=>t.name===name);const d=current();d.base=selected.source;d.revision=catalog.revision;keep();list();render();$('template-reload').hidden=true;feedback('Saved template reloaded. Your draft is kept; compare and review it before saving.');}catch(error){feedback(error.message,true);}};
+  $('template-save').onclick=async()=>{if(busy||!dirty())return;const name=selected.name,d=current();busy=true;$('template-save').disabled=true;$('template-dialog').querySelector('.template-layout').inert=true;$('close-templates').disabled=true;try{catalog=await api('templates/save',{name,source:d.source,expectedRevision:d.revision,reset:d.reset});selected=catalog.templates.find(t=>t.name===name);drafts.delete(name);localStorage.removeItem(key(name));busy=false;list();select(selected);feedback('Template saved to runlist.templates.json. New documents use it.');}catch(error){feedback(error.message,true);keep();if(error.code==='template-conflict')$('template-reload').hidden=false;}finally{busy=false;$('template-dialog').querySelector('.template-layout').inert=false;$('template-save').disabled=false;$('close-templates').disabled=false;}};
+  document.addEventListener('keydown',event=>{if($('template-dialog').open&&(event.metaKey||event.ctrlKey)&&event.key==='s'){event.preventDefault();$('template-review-button').click();}});
+}

package/assets/app/theme.mjs

@@ -0,0 +1,25 @@
+// Run before the stylesheet so a saved theme also applies to the first paint.
+(() => {
+  const key = 'runlist:appearance', system = matchMedia('(prefers-color-scheme: dark)');
+  const valid = value => ['system', 'light', 'dark'].includes(value) ? value : 'system';
+  let preference = 'system';
+  try { preference = valid(localStorage.getItem(key)); } catch { /* A theme still works without storage. */ }
+  function apply() {
+    document.documentElement.dataset.theme = preference === 'system' ? system.matches ? 'dark' : 'light' : preference;
+    const control = document.getElementById('theme-mode');
+    if (control) control.value = preference;
+  }
+  apply();
+  system.addEventListener('change', apply);
+  window.addEventListener('storage', event => {
+    if (event.key === key || event.key === null) { preference = valid(event.newValue); apply(); }
+  });
+  document.addEventListener('DOMContentLoaded', () => {
+    const control = document.getElementById('theme-mode');
+    apply();
+    control.addEventListener('change', () => {
+      preference = valid(control.value); apply();
+      try { localStorage.setItem(key, preference); } catch { /* Keep the selected appearance for this tab. */ }
+    });
+  });
+})();

package/assets/app/transport.mjs

@@ -0,0 +1,43 @@
+export const desktop=typeof window!=='undefined'&&!!window.__TAURI__?.core;
+export function isDesktopAssetLink(url, current) {
+  const asset=value=>!value.username&&!value.password&&!value.port&&((value.protocol==='tauri:'&&value.hostname==='localhost')||(value.protocol==='http:'&&value.hostname==='tauri.localhost'));
+  return asset(current)&&asset(url)&&url.protocol===current.protocol&&url.host===current.host;
+}
+const invoke=(command,args)=>window.__TAURI__.core.invoke(command,args).catch(value=>{const error=new Error(value.message??'The native operation failed.');Object.assign(error,value);throw error;});
+let handle=null;
+export async function request(route,body,csrf) {
+  if(desktop){
+    if(route==='session'){const state=await invoke('desktop_status');handle=state.handle;if(!handle)throw new Error('Choose a checkout folder to get started.');return {actor:state.actor,csrf:null};}
+    if(route==='logout'){const result=await invoke('close_checkout',{handle});handle=null;return result;}
+    if(!handle)throw new Error('Open a checkout folder.');
+    return invoke('checkout_request',{handle,route,...(body===undefined?{}:{body})});
+  }
+  const response=await fetch(`/api/${route}`,body===undefined?{}:{method:'POST',headers:{'Content-Type':'application/json','X-Runlist-CSRF':csrf??''},body:JSON.stringify(body)});
+  const value=await response.json();if(!response.ok){const error=new Error(value.message);Object.assign(error,value);throw error;}return value;
+}
+export const copyText=text=>desktop?invoke('copy_text',{text}):navigator.clipboard.writeText(text);
+export async function mountDesktop({beforeLeave,bootstrap,notice}) {
+  if(!desktop)return false;
+  const $=id=>document.getElementById(id);
+  $('connect-panel').hidden=true;$('desktop-welcome').hidden=false;$('desktop-open').hidden=false;
+  $('disconnect').textContent='Close folder';
+  $('bookmark-empty').textContent='Star a heading to keep it here. Bookmarks stay in Runlist on this computer.';
+  const footer=document.querySelector('.sidebar-footer');footer.replaceChildren(document.createTextNode('Local files · This computer only'),document.createElement('br'));const label=document.createElement('span');label.textContent='Save here. Review local commits in Changes.';footer.append(label);
+  async function recent(){const state=await invoke('desktop_status');const root=$('desktop-recents');root.replaceChildren();for(const item of state.recent){const button=document.createElement('button');button.className='quiet recent-checkout';button.textContent=item.path;button.onclick=()=>choose(item.id);root.append(button);}return state;}
+  let moving=false;
+  async function choose(id){if(moving)return;moving=true;try{
+    await beforeLeave();notice('Choose a trusted local checkout…');
+    const result=await invoke('choose_checkout',id===undefined?{}:{recent:id});
+    if(result.cancelled){notice('Folder opening cancelled.');return;}
+    // A fresh renderer clears controller and document authority from the old checkout.
+    location.replace(location.pathname);
+  }catch(error){notice(error.message,true);}finally{moving=false;}}
+  $('desktop-open').onclick=()=>choose();$('desktop-choose').onclick=()=>choose();
+  await window.__TAURI__.event.listen('runlist:open',()=>choose());
+  await window.__TAURI__.event.listen('runlist:edit',event=>{if(['undo','redo'].includes(event.payload))document.execCommand(event.payload);});
+  await window.__TAURI__.event.listen('runlist:quit',async()=>{if(moving)return;moving=true;try{await beforeLeave();notice('Preserving drafts and finishing local operations…');await invoke('finish_quit');}catch(error){notice(error.message,true);moving=false;}});
+  document.addEventListener('click',event=>{const anchor=event.target.closest('a');if(!anchor)return;const url=new URL(anchor.href,location.href);if(isDesktopAssetLink(url,new URL(location.href)))return;event.preventDefault();if(['http:','https:','mailto:'].includes(url.protocol))invoke('open_external',{url:url.href}).catch(error=>notice(error.message,true));},true);
+  const state=await recent();if(state.handle){$('desktop-welcome').hidden=true;$('desktop-location').hidden=false;$('desktop-location').textContent=state.checkoutPath;await bootstrap();}else notice('Local files · This computer only. Open a checkout folder.');
+  return true;
+}
+export async function desktopDisconnected(){if(!desktop)return;location.replace(location.pathname);}