runlist 0.0.0 → 0.94.1

package/assets/app/app.mjs

@@ -0,0 +1,381 @@
+import {desktop,request,copyText,mountDesktop,desktopDisconnected} from './transport.mjs';
+import {documentCreation} from './document-create.mjs';
+import {quickNavigation} from './quick-navigation.mjs';
+import {recoveryCenter} from './recovery-center.mjs';
+import {appSettings} from './settings.mjs';
+import {documentLifecycle} from './document-lifecycle.mjs';
+import { recordNavigation } from './record-navigation.mjs';
+import { libraryNavigation } from './library-navigation.mjs';
+import { gitChanges } from './git-changes.mjs';
+import { gitCommit } from './git-commit.mjs';
+import { editorNavigation } from './editor-navigation.mjs';
+import { templateEditor } from './template-editor.mjs';
+import { BlockEditor } from './block-editor.mjs';
+import { documentViews } from './document-views.mjs';
+import { documentStages } from './document-stages.mjs';
+import { documentYardstick } from './document-yardstick.mjs';
+import { filingNavigation } from './filing-navigation.mjs';
+import { escapeHtml as esc, splitSource, editedSource, markdownHtml, lineDiff, diffHtml, readSourceStage, replaceSourceStage, rebaseSourceStage } from './shared.mjs';
+const $ = id => document.getElementById(id);
+const state = { doc:null, base:null, body:'', csrf:null, mode:'read', dirty:false, draft:null, recovery:null, conflict:null, pending:null, lastSave:null, busy:false, plans:[] };
+const clientId = sessionStorage.runlistClientId ||= crypto.randomUUID();
+let checkoutKey = '', draftTimer, persistence = Promise.resolve();
+let editorPath;
+const blockEditor = new BlockEditor($('block-editor'),{onChange:body=>bodyChanged(body),resolveLink:linked});
+const navigation = editorNavigation({state,editor:blockEditor,checkout:()=>checkoutKey,$,view,notice});
+templateEditor({api,$,checkout:()=>checkoutKey,notice});
+const library = libraryNavigation({state,$,api,open,showLibrary,checkout:()=>checkoutKey,notice});
+const settings=appSettings({$,api,checkout:()=>checkoutKey,library,notice});
+const lifecycle=documentLifecycle({state,$,api,checkout:()=>checkoutKey,open,library,notice});
+const yardstick=documentYardstick({state,$,api,checkout:()=>checkoutKey,open,library,notice});
+const filing=filingNavigation({state,$,api,open,showLibrary,checkout:()=>checkoutKey,notice});
+const records = recordNavigation({state,$,api,open,showLibrary,checkout:()=>checkoutKey,preferences:()=>settings.read(),notice,create:template=>creation.show({template})});
+const changes=gitChanges({state,$,api,open,showLibrary,checkout:()=>checkoutKey,notice,returnToDraft:()=>{view(state.doc.editable?'edit':'read');const url=new URL(location.href);url.searchParams.delete('view');url.searchParams.set('path',state.doc.path);history.replaceState(null,'',url);}});
+const commits=gitCommit({$,api,checkout:()=>checkoutKey,selection:changes.selectedPaths,changed:()=>changes.invalidate(),notice});
+$('changes-commit').onclick=()=>{if(!$('changes-commit').disabled)return commits.show().catch(error=>notice(error.message,true));};
+const views = documentViews({$,view});
+const stages = documentStages({state,$,changed:word=>{state.draftSource=replaceSourceStage(candidate(),word);bodyChanged(state.body);}});
+const creation=documentCreation({$,api,checkout:()=>checkoutKey,state,beforeNavigate:beforeDesktopLeave,open,library,notice,createdRecord:record=>records.show(record.type==='flag'?'flags':'decisions',record.id)});
+const recoveryCenterView=recoveryCenter({$,api,checkout:()=>checkoutKey,beforeNavigate:beforeDesktopLeave,resume:resumeRecovery,notice});
+const quick=quickNavigation({$,api,state,library,open,jump:section=>navigation.jumpTo(section),notice,actions:()=>[
+  {title:'New document…',run:()=>creation.show()},
+  {title:'New flag…',detail:'Record a finding for triage',run:()=>creation.show({template:'flag'})},
+  {title:'New decision…',detail:'Compare alternatives before ruling',run:()=>creation.show({template:'decision'})},
+  {title:'Recovery',detail:'Drafts and interrupted operations',run:()=>recoveryCenterView.show()},
+  {title:'Changes',detail:'Review saved documents against local Git history',run:()=>changes.show()},
+  {title:'Filing',detail:'Find plans without a home or with competing homes',run:()=>filing.show()},
+  {title:'Library',run:showLibrary},{title:'Active plans',run:()=>library.applyView('active-plans')},{title:'Hubs',run:()=>library.applyView('hubs')},
+  {title:'Flags needing attention',run:()=>records.show('flags')},{title:'Decisions needing attention',run:()=>records.show('decisions')},
+  {title:'Templates',run:()=>$('open-templates').click()},{title:'Settings',run:()=>$('open-settings').click()},
+  ...(library.savedViews?.()??[]).map(v=>({title:`View: ${v.name}`,detail:'Saved library filters',run:()=>library.applyView(v.id)})),
+]});
+function notice(message, error = false) { $('notice').textContent = message; $('notice').classList.toggle('error', error); }
+async function api(route,body) {const result=await request(route,body,state.csrf);if(body!==undefined&&['save','undo','create/commit','lifecycle/commit','yardstick/commit','native/action','flags/triage'].includes(route)){changes.invalidate();filing.invalidate();}return result;}
+function guarded(fn) { return async () => { try { await fn(); } catch (error) { notice(error.message, true); } }; }
+function key(path = state.doc?.path) { return `runlist:recovery:${checkoutKey}:${encodeURIComponent(path)}:${clientId}`; }
+function recoverySource() {
+  if (state.pending?.kind === 'undo') return state.pending.source;
+  try { return candidate(); } catch { return splitSource(state.draftSource ?? state.base.source).envelope + state.body; }
+}
+function storeLocal() {
+  if (!state.doc || !state.base) return;
+  const record = { path:state.doc.path, baseSource:state.base.source, baseRevision:state.base.revision, source:recoverySource(), draft:state.draft, pending:state.pending, lastSave:state.lastSave, conflicted:!!state.conflict, at:Date.now() };
+  try { localStorage.setItem(key(), JSON.stringify(record)); state.recoveryStored = true; } catch { state.recoveryStored = false; notice(`${desktop?'Runlist':'Browser'} recovery storage is full. Keep this tab open until the draft is saved to disk.`, true); }
+}
+function findRecovery(path) {
+  const prefix = `runlist:recovery:${checkoutKey}:${encodeURIComponent(path)}:`;
+  const records = [];
+  try { for (let i = 0; i < localStorage.length; i++) {
+    const location = localStorage.key(i); if (!location.startsWith(prefix)) continue;
+    try { records.push({ ...JSON.parse(localStorage.getItem(location)), location }); } catch { /* Ignore unreadable browser entries, not disk state. */ }
+  }
+  } catch { /* Disk recovery remains available when renderer storage cannot be read. */ }
+  return records.find(r => r.location === key(path)) ?? records.sort((a,b) => b.at - a.at)[0];
+}
+function linked(href) {
+  const target=href.split('#')[0];
+  if(!target.endsWith('.md')||/^(?:[a-z][a-z0-9+.-]*:|\\|\/\/)/i.test(target))return null;
+  return `?ref=${encodeURIComponent(href)}&from=${encodeURIComponent(state.doc?.path??'')}`;
+}
+
+function candidate() { return state.pending?.kind === 'undo' ? state.pending.source : editedSource(state.draftSource ?? state.base.source, state.body); }
+function updateDirty() {
+  state.dirty = candidate() !== state.base.source;
+  const rows = lineDiff(state.base.source, candidate()), adds = rows.filter(r => r.kind === 'add').length, removes = rows.filter(r => r.kind === 'remove').length;
+  $('change-count').textContent = state.dirty ? `${adds + removes}` : '';
+  $('review-summary').textContent = `${adds} added ${adds === 1 ? 'line' : 'lines'} · ${removes} removed ${removes === 1 ? 'line' : 'lines'} · ${state.doc.path}`;
+  const claimed = state.doc.claim?.state === 'owned' || state.doc.claim?.corrupt;
+  $('save').disabled = !state.dirty || !state.doc.editable || claimed || !!state.conflict || state.busy;
+  $('edit').disabled = !state.doc.editable || state.busy;
+  $('tab-edit').disabled = !state.doc.editable || state.busy;
+  $('undo').disabled = !state.lastSave || state.dirty || claimed || state.busy;
+  $('body-editor').readOnly = !!state.pending;
+  blockEditor.setReadOnly(!!state.pending || !state.doc.editable);
+  $('toggle-markdown').disabled = !!state.pending;
+  $('pending-note').hidden = !state.pending;
+  stages.update(candidate());
+  yardstick.update();
+  $('save').textContent = state.pending ? state.pending.kind === 'undo' ? 'Retry undo' : 'Retry save' : 'Save changes';
+}
+function view(mode) {
+  if (!state.doc) return;
+  state.mode = mode;
+  $('records-home').hidden=true;records.deactivate();changes.deactivate();filing.deactivate();
+  $('workspace').classList.remove('library-start');$('empty').hidden=true;$('document').hidden=false;
+  $('doc-title').textContent=state.doc.title;$('doc-path').textContent=state.doc.path;$('doc-status').textContent=state.doc.status??'';
+  views.update(mode);
+  const source = candidate();
+  $('reading').innerHTML = markdownHtml(state.dirty ? source : state.doc.source, linked);
+  $('full-source').textContent = state.doc.source;
+  $('diff').innerHTML = diffHtml(state.base.source, source);
+  updateDirty();
+  if (mode === 'read' && state.dirty) notice('Previewing your draft. It has not been saved to the file.');
+  if (mode === 'edit' && (editorPath !== state.doc.path || blockEditor.source() !== state.body)) { blockEditor.set(state.body,{readOnly:!!state.pending || !state.doc.editable}); editorPath=state.doc.path; }
+  if (mode !== 'edit') blockEditor.hideTools();
+  navigation.update();library.render();
+}
+function renderList() { library.render(); }
+
+function renderDocumentSummary() {
+  $('doc-title').textContent=state.doc.title;
+  const plan=state.plans.find(p=>p.path===state.doc.path);
+  if(plan){plan.title=state.doc.title;plan.status=state.doc.status;const selected=readSourceStage(state.doc.source);plan.stage=selected.word;plan.stageInvalid=selected.invalid;}library.opened();
+}
+function renderEvidence() {
+  const doc = state.doc;
+  renderConnections();
+  $('file-info').innerHTML = `<dl><dt>Source file</dt><dd>${esc(doc.path)}</dd><dt>Revision</dt><dd><code>${esc(doc.revision.slice(0,23))}…</code></dd><dt>Actor</dt><dd>${esc($('identity').textContent)}</dd></dl><p class="muted">Source is the record. Save changes the file; derived views read it again.</p>`;
+  $('flags').innerHTML = doc.flags.length ? doc.flags.map(flag => `<section class="flag"><span class="flag-tag">${esc(flag.id)} · ${esc(flag.severity)} · ${esc(flag.state)}</span><h3>${esc(flag.text)}</h3><h4>ORIGINAL OBSERVATION</h4><small>${esc(flag.original.file)}${flag.original.line ? `:${flag.original.line}` : ''}<br>${esc(flag.original.at ?? '')}</small><pre>${esc(flag.original.quote || 'File-level observation; no original quote was recorded.')}</pre><small>${esc(flag.original.revisionReason)}</small><h4>CURRENT LOCATION · ${esc(flag.current.status.toUpperCase())}</h4><pre class="current-quote">${esc(flag.current.quote ?? 'Current evidence is unavailable or ambiguous.')}</pre><small>${flag.current.line ? `Line ${flag.current.line} · ` : ''}${esc(flag.current.revision?.slice(0,23) ?? 'No current revision')}<br>Original evidence is retained.</small></section>`).join('') : '<p class="muted">No related flags recorded for this document.</p>';
+}
+function renderConnections() {
+  const root=$('document-connections'),relations=state.doc.relationships??[];root.hidden=!relations.length;root.replaceChildren();
+  for(const label of [...new Set(relations.map(r=>r.label))]) {
+    const details=document.createElement('details'),items=relations.filter(r=>r.label===label),summary=document.createElement('summary');summary.textContent=`${label} · ${items.length}`;details.append(summary);let visible=0;
+    const more=document.createElement('button');more.className='quiet small';more.textContent='Show more';const append=()=>{for(const relation of items.slice(visible,visible+20)){const button=document.createElement('button');button.className='connection-link quiet';button.disabled=!relation.target;button.textContent=relation.target?`${relation.target.title} · ${relation.target.status}`:`${relation.ref} · unavailable`;button.title=relation.target?.path??relation.ref;if(relation.target)button.onclick=guarded(()=>open(relation.target.path));details.insertBefore(button,more);}visible+=20;more.hidden=visible>=items.length;};details.append(more);more.onclick=append;append();root.append(details);
+  }
+}
+async function open(path,selection={}) {
+  if (state.busy) throw new Error('Wait for the current operation before switching plans.');
+  await yardstick.beforeLeave();
+  clearTimeout(draftTimer);
+  if (state.doc && (state.dirty || state.pending)) { storeLocal(); await persistDraft(); if(!state.recoveryStored)throw new Error('Preserve your current draft before switching documents.'); }
+  notice('Opening document…');
+  path=await lifecycle.resolveInitial(path);
+  path=await yardstick.resolveInitial(path);
+  const doc = await api(`document?path=${encodeURIComponent(path)}`);
+  state.doc = doc; state.draftSource = doc.source; state.base = { source:doc.source, revision:doc.revision }; state.body = splitSource(doc.source).body.replaceAll('\r\n','\n');
+  state.dirty = false; state.conflict = null; state.pending = null; state.lastSave = null; state.draft = null;
+  let recovery = selection.location ? {...JSON.parse(localStorage.getItem(selection.location)),location:selection.location} : findRecovery(doc.path);
+  if(selection.draftId||!recovery||recovery.source===recovery.baseSource&&!recovery.pending) {
+    const draftId=selection.draftId??(await api(`recovery?${new URLSearchParams({path:doc.path,limit:'200'})}`)).items.find(item=>item.kind==='draft'&&item.available)?.draftId;
+    if(draftId){const disk=await api('draft/read',{path:doc.path,draftId});if(disk)recovery={...disk,draft:{id:disk.id,revision:disk.revision},location:key(doc.path),pending:disk.pendingOperation?{...disk.pendingOperation,path:doc.path,source:disk.source}:null,at:Date.parse(disk.at)};}
+  }
+  state.recovery = recovery;
+  if (recovery?.draft) {
+    const disk = await api('draft/read',{ path:doc.path, draftId:recovery.draft.id });
+    if (disk && (!recovery.source || recovery.source === recovery.baseSource)) { recovery.source = disk.source; recovery.baseSource = disk.baseSource; recovery.baseRevision = disk.baseRevision; recovery.draft.revision = disk.revision; }
+  }
+  if (recovery?.lastSave) state.lastSave = recovery.lastSave;
+  const recoverable = recovery && (recovery.source !== recovery.baseSource || recovery.pending);
+  $('recovery').hidden = !recoverable;
+  $('recovery-label').textContent = recoverable ? 'A locally preserved draft is available. Recover it to review changes; the Markdown file is unchanged.' : '';
+  $('draft-status').textContent = recoverable ? 'Draft available' : 'Saved source';
+  $('claim').hidden = !(doc.claim?.corrupt || doc.claim?.state === 'owned' || !doc.editable);
+  $('claim').textContent = doc.claim?.corrupt ? 'Ownership is corrupt. Repair it through the CLI before saving.' : doc.claim?.state === 'owned' ? `Owned by session ${doc.claim.sessionId}. You can keep a draft; coordinate or release the claim through the CLI before saving.` : !doc.editable ? 'This source is read only. Its format or metadata needs repair before saving.' : '';
+  $('conflict').hidden = true; $('operation-repair').hidden = true; $('empty').hidden = true; $('document').hidden = false;$('workspace').classList.remove('library-start');
+  $('doc-title').textContent = doc.title; $('doc-path').textContent = doc.path; $('doc-status').textContent = doc.status ?? '';
+  $('body-editor').value = state.body; $('markdown-fallback').hidden=true; $('block-editor').hidden=false; $('toggle-markdown').textContent='Edit Markdown'; $('toggle-markdown').setAttribute('aria-expanded','false'); renderList(); renderEvidence(); view(doc.editable?'edit':'read');
+  const url = new URL(location.href); url.searchParams.delete('ref');url.searchParams.delete('from');url.searchParams.delete('view');url.searchParams.delete('record');url.searchParams.set('path',doc.path); history.replaceState(null,'',url);
+  library.opened();
+  await yardstick.opened();
+  let sourceNotice=null;
+  if(selection.line) {
+    view('source');
+    if(selection.expectedRevision&&selection.expectedRevision!==doc.revision)sourceNotice='This hub changed since the filing report. Current source is open; refresh Filing before using its recorded line.';
+    else {
+      const line=Math.floor(Number(selection.line)),lines=doc.source.split('\n');
+      if(line>=1&&line<=lines.length){const mark=document.createElement('mark');mark.className='source-location';mark.tabIndex=-1;mark.setAttribute('aria-label',`Source line ${line}`);mark.textContent=lines[line-1];$('full-source').replaceChildren(document.createTextNode(lines.slice(0,line-1).join('\n')+(line>1?'\n':'')),mark,document.createTextNode((line<lines.length?'\n':'')+lines.slice(line).join('\n')));mark.focus();mark.scrollIntoView({block:'center'});}
+      else sourceNotice='The recorded line is unavailable. Current hub source is open.';
+    }
+  }
+  $('sidebar').classList.remove('open');$('toggle-plans').setAttribute('aria-expanded','false');if(!selection.line)window.scrollTo(0,0); notice(sourceNotice??(doc.editable?'Your document is ready to edit. Changes are kept as a draft until you save.':'This document is read only. Its source is preserved.'),!!sourceNotice);
+}
+async function persistDraft() {
+  if (!state.doc || !state.base || (!state.dirty && !state.pending)) return;
+  state.draft ||= { id:crypto.randomUUID(), revision:null };
+  storeLocal();
+  const request = { path:state.doc.path, draftId:state.draft.id, expectedDraftRevision:state.draft.revision, baseSource:state.base.source, baseRevision:state.base.revision, source:recoverySource(),pendingOperation:state.pending?{operationId:state.pending.operationId,kind:state.pending.kind??'save',expectedRevision:state.pending.expectedRevision,...(state.pending.kind==='undo'?{undoOf:state.pending.undoOf}:{})}:null };
+  const path = state.doc.path, id = state.draft.id;
+  const run = async () => {
+    try {
+      // Queued calls must use the most recently acknowledged draft revision.
+      if (state.doc?.path !== path || state.draft?.id !== id) return;
+      request.expectedDraftRevision = state.draft.revision;
+      const stored = await api('draft/write', request);
+      if (state.doc?.path === path && state.draft?.id === id) { state.draft.revision = stored.revision; storeLocal(); state.recoveryStored=true; $('draft-status').textContent = 'Draft preserved locally · not saved to Markdown'; }
+    } catch (error) { $('draft-status').textContent = desktop?'Draft kept in Runlist':'Draft kept in browser'; notice(error.code === 'draft-conflict' ? 'Another editor updated the disk draft. Your text is kept locally; recover or copy it before proceeding.' : `Draft kept ${desktop?'in Runlist':'in browser'}. ${error.message}`, true); }
+  };
+  persistence = persistence.then(run,run); await persistence;
+}
+function conflict(error) {
+  state.conflict = error.details;
+  $('conflict').hidden = false;
+  $('current-diff').innerHTML = diffHtml(state.base.source, error.details.currentSource);
+  $('draft-diff').innerHTML = diffHtml(state.base.source, candidate());
+  $('current-source').textContent = error.details.currentSource; $('base-source').textContent = state.base.source;
+  storeLocal();notice('Save stopped: another edit changed the file. Your draft is kept.',true); view('edit'); $('conflict').scrollIntoView({ block:'start', behavior:'auto' });
+}
+async function recover() {
+  const r = state.recovery; if (!r) return;
+  state.base = { source:r.baseSource, revision:r.baseRevision }; state.draftSource = r.source; state.body = splitSource(r.source).body.replaceAll('\r\n','\n');
+  state.draft = r.location === key() ? r.draft : null; state.pending = r.pending; state.lastSave = r.lastSave;
+  $('body-editor').value = state.body; $('recovery').hidden = true; updateDirty(); storeLocal(); view('edit');
+  if (state.pending) notice('An interrupted save is retained. Review changes and retry to learn its original outcome.');
+  else notice('Draft recovered. Review changes before saving.');
+  if (state.base.revision !== state.doc.revision && !state.pending) conflict({ details:{ currentRevision:state.doc.revision, currentSource:state.doc.source } });
+}
+async function clearDraft() {
+  if (state.draft?.revision) await api('draft/discard', { path:state.doc.path, draftId:state.draft.id, expectedDraftRevision:state.draft.revision });
+  state.draft = null;
+}
+async function save() {
+  clearTimeout(draftTimer); await persistDraft();
+  const source = candidate();
+  if (state.pending && (state.pending.source !== source || state.pending.expectedRevision !== state.base.revision)) throw new Error('An interrupted save has a different payload. Recover or settle that operation before creating another save.');
+  state.pending ||= { path:state.doc.path, operationId:crypto.randomUUID(), expectedRevision:state.base.revision, source };
+  // Retain the original request identity on disk before publication, even if renderer storage is later lost.
+  await persistDraft();
+  if(!state.recoveryStored)throw new Error('Preserve the draft and operation identity before saving.');
+  storeLocal(); state.busy = true; $('workspace').inert = true; updateDirty(); notice('Saving the reviewed source…');
+  try {
+    const result = await api(state.pending.kind === 'undo' ? 'undo' : 'save',state.pending), pending = state.pending;
+    const current = await api(`document?path=${encodeURIComponent(state.doc.path)}`);
+    if (result.state !== 'committed') throw new Error('Save outcome is not committed. The draft remains available.');
+    state.lastSave = pending.kind === 'undo' ? null : { operationId:result.operationId, revision:result.revision };
+    state.pending = null;
+    if (current.revision !== result.revision) {
+      state.doc = current;
+      // Historical retry success is not authority to throw away a later edit.
+      state.base = { source:pending.source, revision:result.revision }; state.draftSource = pending.source;
+      state.body = splitSource(pending.source).body.replaceAll('\r\n','\n'); storeLocal();
+      conflict({ details:{ currentRevision:current.revision, currentSource:current.source } });
+      return;
+    }
+    state.doc = current; state.draftSource = current.source; state.base = { source:current.source, revision:current.revision }; state.body = splitSource(current.source).body.replaceAll('\r\n','\n');
+    state.dirty = false; storeLocal(); let cleanupError = null;
+    try { await clearDraft(); } catch (error) { cleanupError = error; }
+    $('body-editor').value = state.body; $('draft-status').textContent = 'Saved source'; storeLocal(); renderDocumentSummary(); renderEvidence(); view('edit');
+    notice(cleanupError ? `Saved to Markdown. Recovery draft retained: ${cleanupError.message}` : pending.kind === 'undo' ? 'Undid the save. The CLI reads the same file.' : 'Saved to Markdown. The CLI reads the same file.', !!cleanupError);
+  } catch (error) {
+    if (error.code === 'revision-conflict') { state.pending = null; storeLocal(); conflict(error); }
+    else if (['repair-required','operation-pending'].includes(error.code)) {
+      await inspectOperation(error.details.operationId); notice(error.message,true);
+    } else if (['claim-conflict','managed-fields','invalid-record','invalid-stage','forbidden'].includes(error.code)) {
+      try { if (!await api('operation/inspect',{ operationId:state.pending.operationId })) { state.pending = null; storeLocal(); } } catch { /* Keep uncertain evidence when authority prevents inspection. */ }
+      notice(error.message,true);
+    }
+    else { notice(`Save outcome is uncertain. Your draft and operation ID are kept; retry the same save. ${error.message}`,true); }
+  } finally { state.busy = false; $('workspace').inert = false; updateDirty(); }
+}
+async function inspectOperation(operationId) {
+  const operation = await api('operation/inspect',{ operationId });
+  if (!operation) throw new Error('The retained operation could not be found. Keep your draft for manual review.');
+  state.repair = operation; $('operation-repair').hidden = false;
+  $('repair-label').textContent = `Operation ${operation.id} is ${operation.state}. Inspect its images. Settlement keeps the current file unchanged.`;
+  $('repair-evidence').textContent = `BEFORE\n${operation.before}\n\nAFTER\n${operation.after}\n\nCURRENT SOURCE\n${operation.currentSource}\n\nCURRENT REVISION\n${operation.currentRevision}`;
+}
+async function bootstrap(token) {
+  const session = token ? await api('session',{ token }) : await api('session');
+  state.csrf = session.csrf; $('identity').textContent = `${session.actor.label ?? 'Local user'} · human`;
+  $('disconnect').hidden = false; $('connect-panel').hidden = true;
+  for(const id of ['new-document','quick-open','open-recovery'])$(id).hidden=false;
+  const info = await api('library?limit=1');
+  checkoutKey = `${session.actor.id}:${encodeURIComponent(info.checkoutPath)}`;
+  library.restore();await library.preferences(settings.read(),false);const list=await library.load({reset:true});
+  $('checkout').textContent = list.checkout; $('checkout').title = list.checkoutPath; $('workspace').hidden = false;
+  renderList();
+  const params = new URLSearchParams(location.search), fragment = new URLSearchParams(location.hash.slice(1));
+  const resolved=params.has('ref')?await api(`link?${new URLSearchParams({ref:params.get('ref'),from:params.get('from')??''})}`):null;
+  const initial = params.has('ref')?resolved?.path:params.get('path') || fragment.get('path') || list.initialPath;
+  history.replaceState(null,'',location.pathname + location.search);
+  if(params.get('view')==='changes')await changes.show();else if(params.get('view')==='filing')await filing.show();else if (['flags','decisions'].includes(params.get('view'))) await records.show(params.get('view'),params.get('record')); else if (initial) await open(initial); else await showLibrary();
+  records.counts().catch(()=>{});
+}
+async function showLibrary() {
+  if(state.busy)throw new Error('Wait for the current operation before returning to the library.');
+  await yardstick.beforeLeave();
+  clearTimeout(draftTimer);
+  if(state.doc&&(state.dirty||state.pending)){storeLocal();await persistDraft();if(!state.recoveryStored)throw new Error('Preserve your current draft before leaving the document.');}
+  state.mode='home';blockEditor.hideTools();$('records-home').hidden=true;records.deactivate();changes.deactivate();filing.deactivate();
+  $('workspace').classList.add('library-start');$('evidence').classList.remove('outline-open');
+  $('document').hidden=true;$('empty').hidden=false;$('doc-path').textContent='';
+  $('sidebar').classList.remove('open');$('toggle-plans').setAttribute('aria-expanded','false');
+  const url=new URL(location.href);for(const key of ['path','ref','from','view','record'])url.searchParams.delete(key);history.replaceState(null,'',url);
+  library.render();window.scrollTo(0,0);
+  notice(state.doc&&(state.dirty||state.pending)?'Library ready. Your document draft stays available when you reopen it.':'Library ready.');
+}
+$('document-changes').onclick=guarded(()=>changes.show());
+$('library-home').onclick=guarded(showLibrary);
+$('back-library').onclick=guarded(showLibrary);
+$('toggle-plans').onclick = () => $('toggle-plans').setAttribute('aria-expanded',String($('sidebar').classList.toggle('open')));
+for (const name of ['read','edit','review','source']) $('tab-' + name).onclick = guarded(() => view(name));
+$('edit').onclick = guarded(() => view(state.dirty ? 'review' : 'edit')); $('review').onclick = guarded(() => view('review')); $('back-edit').onclick = () => view('edit');
+function bodyChanged(body) {
+  state.body = body;
+  navigation.update();
+  $('body-editor').value = body;
+  storeLocal();
+  try { updateDirty(); storeLocal(); $('draft-status').textContent = state.dirty ? 'Saving draft…' : 'Saved source'; clearTimeout(draftTimer); if(state.dirty) draftTimer = setTimeout(() => persistDraft(),500); }
+  catch (error) { $('save').disabled = true; notice(error.message,true); }
+}
+$('body-editor').oninput = () => bodyChanged($('body-editor').value);
+$('toggle-markdown').onclick = () => {
+  const showing = $('markdown-fallback').hidden;
+  $('markdown-fallback').hidden = !showing; $('block-editor').hidden = showing;
+  $('toggle-markdown').textContent = showing ? 'Back to document' : 'Edit Markdown';
+  $('toggle-markdown').setAttribute('aria-expanded',String(showing));
+  if (showing) { $('body-editor').value=state.body; $('body-editor').focus(); }
+  else { blockEditor.set(state.body,{readOnly:!!state.pending}); editorPath=state.doc.path; }
+};
+$('save').onclick = guarded(save);
+$('cancel').onclick = guarded(async () => { await persistDraft(); view('read'); notice(state.dirty ? 'Reading your draft preview. Changes are not saved to the file.' : 'Reading saved source.'); });
+$('discard').onclick = guarded(async () => { if (state.pending) throw new Error('Inspect or retry the interrupted save before discarding its recovery data.'); await clearDraft(); state.body = splitSource(state.doc.source).body.replaceAll('\r\n','\n'); state.base = { source:state.doc.source, revision:state.doc.revision }; state.draftSource = state.doc.source; state.pending = null; state.conflict = null; $('conflict').hidden = true; $('body-editor').value = state.body; storeLocal(); $('draft-status').textContent = 'Saved source'; view('edit'); notice('Changes discarded. The Markdown file is unchanged.'); });
+$('recover').onclick = guarded(recover);
+$('discard-recovery').onclick = guarded(async () => {
+  const r = state.recovery;
+  if (r?.pending) throw new Error('This draft contains an interrupted save. Recover it and inspect the outcome before discarding.');
+  if (r?.draft?.revision) await api('draft/discard',{ path:state.doc.path,draftId:r.draft.id,expectedDraftRevision:r.draft.revision });
+  if (r) localStorage.removeItem(r.location); state.recovery = null; $('recovery').hidden = true; notice('Recovery draft discarded. The file is unchanged.');
+});
+$('review-merge').onclick = guarded(async () => { const c = state.conflict; if (!c) return; state.draftSource = rebaseSourceStage(state.base.source,state.draftSource ?? state.base.source,c.currentSource); state.base = { source:c.currentSource, revision:c.currentRevision }; state.pending = null; state.conflict = null; $('conflict').hidden = true; storeLocal(); await persistDraft(); view('review'); notice('Review the merged draft against the current file before saving.'); });
+$('use-current').onclick = guarded(async () => { await persistDraft(); state.doc = await api(`document?path=${encodeURIComponent(state.doc.path)}`); $('reading').innerHTML = markdownHtml(state.doc.source,linked); view('source'); notice('Current source is shown. Your draft and conflict review are retained.'); });
+$('inspect-pending').onclick = guarded(() => inspectOperation(state.pending.operationId));
+$('settle-operation').onclick = guarded(async () => {
+  const r = state.repair; if (!r) return;
+  const outcome = await api('operation/settle',{ operationId:r.id,expectedRevision:r.currentRevision,disposition:'leave-current' });
+  $('operation-repair').hidden = true;
+  if (outcome.state === 'committed' && state.pending?.operationId === r.id) { await save(); return; }
+  state.pending = null; storeLocal(); updateDirty();
+  const current = await api(`document?path=${encodeURIComponent(state.doc.path)}`);
+  if (current.revision !== state.base.revision) conflict({ details:{ currentRevision:current.revision,currentSource:current.source } });
+  notice(`Operation settled as ${outcome.state}. The current file was left unchanged; review your draft before a new save.`);
+});
+$('undo').onclick = guarded(async () => {
+  const previous = state.lastSave;
+  state.busy = true; $('workspace').inert = true;
+  try {
+    const record = await api('operation/inspect',{ operationId:previous.operationId });
+    if (!record) throw new Error('The original save receipt is unavailable. Undo cannot overwrite the file.');
+    state.base = { source:record.after, revision:previous.revision }; state.draftSource = record.before;
+    state.body = splitSource(record.before).body.replaceAll('\r\n','\n'); $('body-editor').value = state.body;
+    state.pending = { path:state.doc.path,operationId:crypto.randomUUID(),undoOf:previous.operationId,expectedRevision:previous.revision,kind:'undo',source:record.before };
+    storeLocal(); updateDirty();
+    await save(); // The same persisted retry and conflict machinery as Save.
+  } finally { state.busy = false; $('workspace').inert = false; updateDirty(); }
+});
+$('reading').addEventListener('click',event=>{const anchor=event.target.closest('a');if(!anchor||event.metaKey||event.ctrlKey||event.shiftKey)return;const url=new URL(anchor.href,location.href);if(url.origin!==location.origin||!url.searchParams.has('ref'))return;event.preventDefault();guarded(async()=>{const target=await api(`link?${new URLSearchParams({ref:url.searchParams.get('ref'),from:url.searchParams.get('from')??''})}`);if(!target)throw new Error('This linked document is unavailable or outside this library.');await open(target.path);})();});
+$('copy-source').onclick = guarded(async () => { await copyText(state.doc.source); notice('Canonical Markdown source copied.'); });
+$('disconnect').onclick = guarded(async () => { await beforeDesktopLeave(); await api('logout',{}); $('workspace').hidden = true; $('connect-panel').hidden = false; for(const id of ['disconnect','new-document','quick-open','open-recovery'])$(id).hidden=true; notice('Disconnected. Private drafts are retained locally.'); await desktopDisconnected(); });
+$('connect-form').onsubmit = event => { event.preventDefault(); guarded(async () => { const value = $('access').value.trim(); let token = value; try { token = new URLSearchParams(new URL(value).hash.slice(1)).get('connect') ?? value; } catch { /* A raw token is also accepted. */ } await bootstrap(token); $('access').value = ''; })(); };
+window.addEventListener('beforeunload', event => { if (state.dirty || state.pending) { storeLocal(); if (!state.recoveryStored) { event.preventDefault(); event.returnValue = ''; } } });
+document.addEventListener('keydown', event => { if (document.querySelector('dialog[open]')) return; if ((event.metaKey || event.ctrlKey) && event.key === 's') { event.preventDefault(); if (state.doc && state.dirty) guarded(() => view('review'))(); } });
+async function beforeDesktopLeave() {
+  if(state.busy)throw new Error('Wait for the current operation before switching folders or quitting.');
+  await yardstick.beforeLeave();
+  if($('template-dialog').open||$('lifecycle-dialog')?.open||$('create-dialog').open||$('git-commit-dialog').open||$('filter-dialog').open||$('record-review')&&!$('record-review').hidden)throw new Error('Close the current review or template editor before switching folders or quitting.');
+  clearTimeout(draftTimer);
+  if(state.doc&&(state.dirty||state.pending)){storeLocal();await persistDraft();if(!state.recoveryStored)throw new Error('Recovery storage is unavailable. Save or preserve your draft before leaving.');}
+  await persistence;
+}
+async function resumeRecovery(row) {
+  if(row.kind==='yardstick'){await yardstick.resume(row);return;}
+  if(row.kind==='git-commit'){await commits.show({operationId:row.operationId});return;}
+  if(row.kind==='creation'){await creation.show(row.operationId?{operationId:row.operationId}:{});return;}
+  if(row.kind==='lifecycle'){await lifecycle.resume(row.operationId);return;}
+  if(row.kind==='record'){await records.show(row.recordKind,row.recordKey);return;}
+  if(row.kind==='operation'){await open(row.path);await inspectOperation(row.operationId);return;}
+  await open(row.path,row.location?{location:row.location}:{draftId:row.draftId});await recover();
+  if(state.pending)await inspectOperation(state.pending.operationId);
+}
+try { if(!await mountDesktop({beforeLeave:beforeDesktopLeave,bootstrap,notice}))await bootstrap(new URLSearchParams(location.hash.slice(1)).get('connect')); }
+catch (error) { if(!desktop)$('connect-panel').hidden = false; notice(error.message,true); }

package/assets/app/block-editor.mjs

@@ -0,0 +1,182 @@
+import { escapeHtml as esc, markdownHtml } from './shared.mjs';
+import { parseBlocks, blocksSource, rewriteBlock, convertBlock, blockPrefixes } from './block-model.mjs';
+const escapeText = s => s.replace(/[\\`*_\[\]~]/g,'\\$&');
+const allowedLink = href => !/^(?:[a-z][a-z0-9+.-]*:|\/\/|\\)/i.test(href) || /^(https?:|mailto:)/i.test(href);
+function inlineHTML(text) {
+  const re=/`([^`\n]+)`|\[([^\]\n]+)\]\(([^\s)]+)\)|\*\*([^\n]+?)\*\*|__([^\n]+?)__|~~([^\n]+?)~~|\*([^*\n]+)\*|_([^_\n]+)_|(?<escaped>\\[\\`*_{}[\]()#+.!>~-])/g;
+  let html='',cursor=0;
+  for(const m of text.matchAll(re)) {
+    html+=esc(text.slice(cursor,m.index)); let tag,inner,attrs='';
+    if(m.groups.escaped){tag='span';inner=esc(m.groups.escaped.slice(1));}
+    else if(m[1]!==undefined){tag='code';inner=esc(m[1]);}
+    else if(m[2]!==undefined){tag='a';inner=inlineHTML(m[2]);attrs=` data-href="${esc(m[3])}"${allowedLink(m[3])?` href="${esc(m[3])}"`:''}`;}
+    else {tag=m[4]!==undefined||m[5]!==undefined?'strong':m[6]!==undefined?'s':'em';inner=inlineHTML(m[4]??m[5]??m[6]??m[7]??m[8]);}
+    html+=`<${tag}${attrs} data-raw="${esc(m[0])}">${inner}</${tag}>`;cursor=m.index+m[0].length;
+  }
+  return html+esc(text.slice(cursor));
+}
+function rememberMarkup(root) { for(const e of root.querySelectorAll('[data-raw]')) e._originalHTML=e.innerHTML; }
+const markText=(text,mark)=>{const [,lead,body,tail]=text.match(/^(\s*)([\s\S]*?)(\s*)$/);return lead+(body?mark+body+mark:'')+tail;};
+function markdownDOM(node) {
+  if(node.nodeType===3)return escapeText(node.data);
+  if(node.nodeType!==1)return '';
+  if(node.dataset.raw!==undefined&&node.innerHTML===node._originalHTML)return node.dataset.raw;
+  if(node.tagName==='BR')return '\n';
+  const text=[...node.childNodes].map(markdownDOM).join('');
+  switch(node.tagName){
+    case 'STRONG': case 'B':return markText(text,'**');
+    case 'EM': case 'I':return markText(text,'*');
+    case 'S': case 'STRIKE':return markText(text,'~~');
+    case 'CODE': {const raw=node.textContent;let fence='`';while(raw.includes(fence))fence+='`';return fence+(raw.startsWith('`')||raw.endsWith('`')?' ':'')+raw+(raw.startsWith('`')||raw.endsWith('`')?' ':'')+fence;}
+    case 'A': {const href=node.dataset.href??node.getAttribute('href')??'';return allowedLink(href)?`[${text}](${href.replace(/[\s()]/g,c=>encodeURIComponent(c))})`:text;}
+    case 'DIV': case 'P':return text+'\n';
+    default:return text;
+  }
+}
+const commands=[['paragraph','Text','Plain paragraph'],['h1','Heading 1','Large heading'],['h2','Heading 2','Section heading'],['h3','Heading 3','Small heading'],['bullet','Bulleted list','A simple list'],['number','Numbered list','A numbered step'],['task','To-do list','Track a task'],['quote','Quote','Set a passage apart'],['code','Code','A code block'],['divider','Divider','A horizontal rule']];
+const MAX_UNDO_ENTRIES=100,MAX_UNDO_BYTES=32*1024*1024;
+// The common edit keeps block boundaries. Compare raw fragments without
+// allocating two complete Unicode document strings on every keystroke.
+const sameSource=(before,after)=>{
+  if(before.length===after.length){
+    let changed=0;
+    for(let i=0;i<before.length;i++)if(before[i].raw!==after[i].raw)changed++;
+    if(changed<2)return changed===0;
+  }
+  return blocksSource(before)===blocksSource(after);
+};
+export class BlockEditor {
+  constructor(root,{onChange,resolveLink}={}) {
+    this.root=root;this.onChange=onChange;this.resolveLink=resolveLink;this.blocks=[];this.history=[];this.future=[];this.readOnly=false;
+    root.classList.add('block-document');root.setAttribute('role','group');root.setAttribute('aria-label','Editable document');
+    root.addEventListener('input',e=>this.input(e));root.addEventListener('keydown',e=>this.keydown(e));
+    root.addEventListener('paste',e=>this.paste(e));root.addEventListener('drop',e=>{e.preventDefault();const el=e.target.closest('[data-editable]');if(!el||this.readOnly)return;const range=document.caretRangeFromPoint?.(e.clientX,e.clientY);if(range&&el.contains(range.startContainer)){getSelection().removeAllRanges();getSelection().addRange(range);this.paste({target:el,preventDefault(){},clipboardData:e.dataTransfer});}});root.addEventListener('click',e=>this.click(e));
+    root.addEventListener('focusin',e=>{const el=e.target.closest('[data-editable]');if(el){this.activeId=el.closest('[data-block]').dataset.block;this.showTools();}});
+    document.addEventListener('selectionchange',()=>this.selectionTools());window.addEventListener('scroll',()=>{this.tools.hidden=true;},true);
+    document.addEventListener('pointerdown',e=>{if(!root.contains(e.target)&&!this.tools?.contains(e.target)&&!this.menu?.contains(e.target))this.closeMenu();});
+    this.tools=document.createElement('div');this.tools.className='block-format';this.tools.hidden=true;this.tools.setAttribute('role','toolbar');this.tools.setAttribute('aria-label','Text formatting');
+    this.tools.innerHTML=`<button data-style="strong" aria-label="Bold" title="Bold · ⌘B"><b>B</b></button><button data-style="em" aria-label="Italic" title="Italic · ⌘I"><i>I</i></button><button data-style="code" aria-label="Inline code">&lt;/&gt;</button><button data-style="s" aria-label="Strikethrough"><s>S</s></button><button data-style="link" aria-label="Add link">Link</button>`;
+    this.tools.onpointerdown=e=>e.preventDefault();this.tools.onclick=e=>{const b=e.target.closest('[data-style]');if(b)this.format(b.dataset.style);};document.body.append(this.tools);
+    this.menu=document.createElement('div');this.menu.className='block-menu';this.menu.hidden=true;this.menu.setAttribute('role','menu');document.body.append(this.menu);
+    this.menu.onpointerdown=e=>e.preventDefault();this.menu.onclick=e=>{const b=e.target.closest('[data-kind]');if(b)this.choose(b.dataset.kind);};
+  }
+  set(body,{readOnly=false}={}) {this.closeMenu();this.tools.hidden=true;this.readOnly=readOnly;this.blocks=parseBlocks(body);this.history=[];this.future=[];this.typing=null;this.render();}
+  source(){return blocksSource(this.blocks);}
+  hideTools(){this.closeMenu();this.tools.hidden=true;}
+  setReadOnly(value){this.readOnly=value;for(const el of this.root.querySelectorAll('[data-editable]')){el.setAttribute('contenteditable',String(!value));el.setAttribute('aria-readonly',String(value));}for(const el of this.root.querySelectorAll('button,input'))el.disabled=value||!!this.blocks.find(b=>b.id===el.closest('[data-block]')?.dataset.block)?.locked;for(const el of this.root.querySelectorAll('textarea'))el.readOnly=value;if(value)this.hideTools();}
+  editable(){return this.root.querySelector(`[data-block="${this.activeId}"] [data-editable]`);}
+  selected(){const s=getSelection();return s?.rangeCount&&this.root.contains(s.anchorNode)&&this.root.contains(s.focusNode)?s:null;}
+  position(){const el=this.editable(),s=this.selected();if(!el||!s||!el.contains(s.focusNode))return {id:this.activeId,offset:0};const range=document.createRange();range.selectNodeContents(el);range.setEnd(s.focusNode,s.focusOffset);return {id:this.activeId,offset:range.toString().length};}
+  focus(id,offset=0){this.activeId=id;const el=this.editable();if(!el)return;el.focus({preventScroll:true});let remaining=offset;const walker=document.createTreeWalker(el,NodeFilter.SHOW_TEXT);let text;while((text=walker.nextNode())){if(remaining<=text.length){const r=document.createRange();r.setStart(text,remaining);r.collapse(true);getSelection().removeAllRanges();getSelection().addRange(r);return;}remaining-=text.length;}const r=document.createRange();r.selectNodeContents(el);r.collapse(false);getSelection().removeAllRanges();getSelection().addRange(r);}
+  snapshot(){
+    // Blocks contain only primitive fields. Copy their mutable objects while
+    // sharing immutable strings; structuredClone duplicates all document text.
+    const blocks=this.blocks.map(block=>({...block}));
+    const bytes=blocks.reduce((sum,block)=>sum+128+Object.values(block).reduce((n,value)=>n+(typeof value==='string'?value.length*2:8),0),0);
+    return {blocks,position:this.position(),bytes};
+  }
+  trimUndo(){
+    let bytes=[...this.history,...this.future].reduce((sum,snapshot)=>sum+snapshot.bytes,0);
+    // Count shared strings conservatively. Keep at least the nearest action,
+    // even if that single document snapshot exceeds the history byte budget.
+    while(this.history.length+this.future.length>1&&(bytes>MAX_UNDO_BYTES||this.history.length+this.future.length>MAX_UNDO_ENTRIES)){
+      const stack=this.history.length>=this.future.length?this.history:this.future;
+      bytes-=stack.shift().bytes;
+    }
+  }
+  commit(previous,{typing=false}={}){
+    if(previous&&!sameSource(previous.blocks,this.blocks)){
+      const now=performance.now(),group=typing&&this.typing?.id===previous.position.id&&now-this.typing.at<800;
+      if(!group)this.history.push(previous);
+      this.typing=typing?{id:previous.position.id,at:now}:null;this.future=[];this.trimUndo();this.onChange?.(this.source());
+    }
+  }
+  mutate(fn){const previous=this.snapshot();fn();this.commit(previous);}
+  render(){
+    this.root.replaceChildren();
+    for(const b of this.blocks){
+      if(['gap','comment'].includes(b.kind))continue;
+      const row=document.createElement('div');row.className=`doc-block block-${b.kind}`;row.dataset.block=b.id;
+      const handle=document.createElement('button');handle.className='block-handle';handle.type='button';handle.textContent='+';handle.title='Add a block below';handle.setAttribute('aria-label','Add block below');handle.dataset.add=b.id;handle.disabled=this.readOnly||b.locked;row.append(handle);
+      if(b.locked||b.kind==='divider') {const content=document.createElement('div');content.innerHTML=markdownHtml(b.raw,this.resolveLink);if(b.locked){row.classList.add('locked-block');const note=document.createElement('div');note.className='block-lock-label';note.textContent='Lifecycle history · read only';row.append(note);}row.append(content);this.root.append(row);continue;}
+      if(b.kind==='source') {const details=document.createElement('details');details.className='source-block';const summary=document.createElement('summary');summary.textContent='Edit this block as Markdown';const preview=document.createElement('div');preview.innerHTML=markdownHtml(b.raw,this.resolveLink);const textarea=document.createElement('textarea');textarea.value=b.raw;textarea.dataset.rawEditor=b.id;textarea.setAttribute('aria-label','Block Markdown');textarea.readOnly=this.readOnly;details.append(summary,textarea);row.append(preview,details);this.root.append(row);continue;}
+      const marker=document.createElement(b.kind==='task'?'input':'span');marker.className='block-marker';
+      if(b.kind==='task'){marker.type='checkbox';marker.checked=b.checked;marker.disabled=this.readOnly;marker.dataset.check=b.id;marker.setAttribute('aria-label',`Complete task: ${b.text}`);row.append(marker);}
+      else if(b.kind==='bullet'||b.kind==='number'){marker.textContent=b.kind==='bullet'?'•':b.prefix.trim();row.append(marker);}
+      const el=document.createElement(/^h[1-6]$/.test(b.kind)?b.kind:b.kind==='code'?'pre':'div');el.className='block-text';el.dataset.editable='true';el.contentEditable=String(!this.readOnly);el.setAttribute('role','textbox');el.setAttribute('aria-multiline','true');el.setAttribute('aria-label',b.kind==='paragraph'?'Paragraph':b.kind==='task'?'Task text':b.kind==='code'?'Code':b.kind.startsWith('h')?'Heading':`${b.kind} text`);el.dataset.placeholder=b.kind==='paragraph'?"Type '/' for blocks":'Type here…';
+      el.tabIndex=0;el.setAttribute('aria-readonly',String(this.readOnly));if(/^h[1-6]$/.test(b.kind))el.setAttribute('aria-description',`Heading level ${b.kind.slice(1)}`);
+      if(b.kind==='code')el.textContent=b.text;else {el.innerHTML=inlineHTML(b.text);rememberMarkup(el);}
+      row.append(el);this.root.append(row);
+    }
+    const add=document.createElement('button');add.className='append-block';add.textContent='+ Add a block';add.disabled=this.readOnly;add.dataset.append='true';this.root.append(add);
+  }
+  input(e){if(this.readOnly)return;const textarea=e.target.closest('[data-raw-editor]');if(textarea){const b=this.blocks.find(b=>b.id===textarea.dataset.rawEditor);this.mutate(()=>{b.raw=textarea.value;});return;}
+    const el=e.target.closest('[data-editable]');if(!el)return;this.activeId=el.closest('[data-block]').dataset.block;const b=this.blocks.find(b=>b.id===this.activeId);const previous=this.snapshot();previous.position={id:b.id,offset:Math.max(0,this.position().offset-1)};rewriteBlock(b,b.kind==='code'?el.innerText:[...el.childNodes].map(markdownDOM).join(''));this.commit(previous,{typing:['insertText','deleteContentBackward','deleteContentForward'].includes(e.inputType)});
+    if(b.kind==='paragraph'&&/^\/[^\n]*$/.test(el.textContent))this.openMenu(b.id,{slash:true,query:el.textContent.slice(1)});else if(!this.menu.hidden&&this.menuSlash)this.closeMenu();
+  }
+  click(e){const link=e.target.closest('a');if(link){e.preventDefault();if(e.metaKey||e.ctrlKey){const href=link.dataset.href??link.getAttribute('href');if(allowedLink(href))window.open(this.resolveLink?.(href)??href,'_blank','noopener');}return;}
+    if(e.target.dataset.check){const b=this.blocks.find(b=>b.id===e.target.dataset.check);this.mutate(()=>{b.checked=e.target.checked;b.prefix=b.prefix.replace(/\[[ xX]\]/,b.checked?'[x]':'[ ]');rewriteBlock(b,b.text);});return;}
+    if(e.target.dataset.add){this.activeId=e.target.dataset.add;this.openMenu(this.activeId,{insert:true});}
+    if(e.target.dataset.append)this.openMenu(this.blocks.filter(b=>!b.locked&&!['gap','comment'].includes(b.kind)).at(-1)?.id,{insert:true});
+  }
+  closeMenu(){this.menu.hidden=true;this.menuSlash=false;}
+  openMenu(id,{slash=false,insert=false,query=''}={}){
+    if(this.readOnly)return;this.menuId=id;this.menuSlash=slash;this.menuInsert=insert;this.menuIndex=0;
+    const matches=commands.filter(c=>`${c[1]} ${c[2]}`.toLowerCase().includes(query.toLowerCase()));this.menuCommands=matches;
+    this.menu.innerHTML='<div class="block-menu-title">'+(insert?'ADD A BLOCK':'TURN INTO')+'</div>'+matches.map((c,i)=>`<button role="menuitem" data-kind="${c[0]}" class="${i===0?'selected':''}"><span>${esc(c[1])}</span><small>${esc(c[2])}</small></button>`).join('');
+    if(!matches.length)this.menu.innerHTML+='<p>No matching block types</p>';
+    this.menu.hidden=false;const row=this.root.querySelector(`[data-block="${id}"]`),rect=(row??this.root).getBoundingClientRect();this.menu.style.left=Math.max(8,Math.min(rect.left,innerWidth-260))+'px';this.menu.style.top=Math.max(8,Math.min(rect.bottom+4,innerHeight-Math.min(420,this.menu.offsetHeight)-8))+'px';
+  }
+  choose(kind){this.mutate(()=>{const id=this.menuId;let b=this.blocks.find(b=>b.id===id);if(this.menuInsert){b=this.insertAfter(b,kind,'');}
+    else if(b){if(this.menuSlash)b.text='';if(kind==='code'){b.kind='code';b.prefix='```\n';b.suffix='\n```'+(b.raw.endsWith('\n')?'\n':'');rewriteBlock(b,b.text);}else if(kind==='divider'){b.kind='divider';b.raw='---'+(b.raw.endsWith('\n')?'\n':'');}else convertBlock(b,kind);}this.closeMenu();this.render();this.focus(b?.id);});}
+  insertAfter(block,kind,text){let index=block?this.blocks.indexOf(block)+1:this.blocks.findIndex(b=>b.locked);if(index<0)index=this.blocks.length;
+    const next=this.blocks[index];if(block&&!block.raw.endsWith('\n'))block.raw+='\n';
+    const fresh={id:crypto.randomUUID(),kind,prefix:kind==='code'?'```\n':blockPrefixes[kind]??'',text,suffix:kind==='code'?'\n```\n':'\n',checked:false,raw:''};rewriteBlock(fresh,text);if(kind==='divider')fresh.raw='---\n';
+    const parts=[];if(!['bullet','number','task'].includes(kind))parts.push({id:crypto.randomUUID(),kind:'gap',raw:'\n'});parts.push(fresh);if(next?.kind!=='gap'&&next)parts.push({id:crypto.randomUUID(),kind:'gap',raw:'\n'});
+    this.blocks.splice(index,0,...parts);return fresh;
+  }
+  selectionTools(){const s=this.selected();if(!s||s.isCollapsed||this.readOnly){this.tools.hidden=true;return;}const start=s.anchorNode.parentElement.closest('[data-editable]'),end=s.focusNode.parentElement.closest('[data-editable]');if(!start||start!==end||start.closest('.block-code')){this.tools.hidden=true;return;}
+    this.savedRange=s.getRangeAt(0).cloneRange();const r=this.savedRange.getBoundingClientRect();this.tools.hidden=false;this.tools.style.left=Math.max(8,Math.min(r.left,innerWidth-this.tools.offsetWidth-8))+'px';this.tools.style.top=Math.max(8,r.top-this.tools.offsetHeight-8)+'px';
+  }
+  showTools(){this.selectionTools();}
+  format(tag){let s=this.selected(),range=s?.rangeCount?s.getRangeAt(0):this.savedRange;if(!range||range.collapsed||!this.root.contains(range.commonAncestorContainer))return;
+    const el=(range.startContainer.nodeType===1?range.startContainer:range.startContainer.parentElement).closest('[data-editable]');if(!el||!el.contains(range.endContainer)||el.closest('.block-code'))return;
+    this.activeId=el.closest('[data-block]').dataset.block;let href;
+    if(tag==='link'){href=window.prompt('Link URL');if(!href)return;if(!allowedLink(href)||/[\s]/.test(href)){window.alert('Use a web, mail, fragment, or relative link without spaces.');return;}tag='a';}
+    this.mutate(()=>{
+      const parent=(range.startContainer.nodeType===1?range.startContainer:range.startContainer.parentElement).closest(tag);
+      if(parent&&el.contains(parent)&&parent.contains(range.endContainer)) {
+        const before=document.createRange();before.selectNodeContents(parent);before.setEnd(range.startContainer,range.startOffset);
+        const after=document.createRange();after.selectNodeContents(parent);after.setStart(range.endContainer,range.endOffset);
+        const left=parent.cloneNode(false),right=parent.cloneNode(false),middle=range.cloneContents();
+        left.removeAttribute('data-raw');right.removeAttribute('data-raw');left.append(before.cloneContents());right.append(after.cloneContents());
+        const replacement=document.createDocumentFragment();if(left.textContent)replacement.append(left);replacement.append(middle);if(right.textContent)replacement.append(right);
+        const offset=this.position().offset;parent.replaceWith(replacement);
+        rewriteBlock(this.blocks.find(b=>b.id===this.activeId),[...el.childNodes].map(markdownDOM).join(''));this.focus(this.activeId,offset);return;
+      }
+      const wrapper=document.createElement(tag);if(href){wrapper.dataset.href=href;wrapper.setAttribute('href',href);}wrapper.append(range.extractContents());range.insertNode(wrapper);const r=document.createRange();r.selectNodeContents(wrapper);s=getSelection();s.removeAllRanges();s.addRange(r);rewriteBlock(this.blocks.find(b=>b.id===this.activeId),[...el.childNodes].map(markdownDOM).join(''));
+    });this.selectionTools();
+  }
+  paste(e){const el=e.target.closest('[data-editable]');if(!el||this.readOnly)return;e.preventDefault();const s=this.selected();if(!s)return;const r=s.getRangeAt(0);if(!el.contains(r.endContainer))return;const text=e.clipboardData.getData('text/plain');r.deleteContents();const node=document.createTextNode(text.replaceAll('\r\n','\n'));r.insertNode(node);r.setStartAfter(node);r.collapse(true);s.removeAllRanges();s.addRange(r);this.input({target:el});}
+  undo(redo=false){this.typing=null;const from=redo?this.future:this.history,to=redo?this.history:this.future;if(!from.length)return;const target=from.pop();to.push(this.snapshot());this.trimUndo();this.blocks=target.blocks;this.closeMenu();this.render();this.focus(target.position.id,target.position.offset);this.onChange?.(this.source());}
+  keydown(e){if(this.readOnly||e.isComposing)return;const el=e.target.closest('[data-editable]');if(!el)return;this.activeId=el.closest('[data-block]').dataset.block;const b=this.blocks.find(b=>b.id===this.activeId),mod=e.metaKey||e.ctrlKey;
+    if(mod&&e.key.toLowerCase()==='z'){e.preventDefault();this.undo(e.shiftKey);return;}if(mod&&e.key.toLowerCase()==='y'){e.preventDefault();this.undo(true);return;}
+    if(mod&&['b','i'].includes(e.key.toLowerCase())){e.preventDefault();this.format(e.key.toLowerCase()==='b'?'strong':'em');return;}
+    if(!this.menu.hidden){if(e.key==='Escape'){e.preventDefault();this.closeMenu();return;}if(['ArrowDown','ArrowUp'].includes(e.key)){e.preventDefault();this.menuIndex=(this.menuIndex+(e.key==='ArrowDown'?1:-1)+this.menuCommands.length)%this.menuCommands.length;[...this.menu.querySelectorAll('[data-kind]')].forEach((b,i)=>b.classList.toggle('selected',i===this.menuIndex));return;}if(e.key==='Enter'){e.preventDefault();const cmd=this.menuCommands[this.menuIndex];if(cmd)this.choose(cmd[0]);return;}}
+    const s=this.selected();if(!s||!el.contains(s.anchorNode)||!el.contains(s.focusNode))return;
+    if(e.key==='Enter'&&e.shiftKey&&b.kind!=='code'){e.preventDefault();const r=s.getRangeAt(0);r.deleteContents();const br=document.createElement('br');r.insertNode(br);r.setStartAfter(br);r.collapse(true);s.removeAllRanges();s.addRange(r);this.input({target:el});return;}
+    if(['ArrowUp','ArrowDown'].includes(e.key)&&s.isCollapsed&&!mod){const offset=this.position().offset;if((e.key==='ArrowUp'&&offset===0)||(e.key==='ArrowDown'&&offset===el.textContent.length)){const elements=[...this.root.querySelectorAll('[data-editable]')],index=elements.indexOf(el),next=elements[index+(e.key==='ArrowUp'?-1:1)];if(next){e.preventDefault();this.focus(next.closest('[data-block]').dataset.block,e.key==='ArrowUp'?next.textContent.length:0);}}}
+    if(e.key==='Enter'&&!e.shiftKey&&b.kind!=='code'){
+      e.preventDefault();this.mutate(()=>{const r=s.getRangeAt(0);r.deleteContents();const tail=document.createRange();tail.selectNodeContents(el);tail.setStart(r.startContainer,r.startOffset);const frag=tail.extractContents();const head=[...el.childNodes].map(markdownDOM).join(''),text=[...frag.childNodes].map(markdownDOM).join('');
+        if(['bullet','number','task','quote'].includes(b.kind)&&!head&&!text){rewriteBlock(b,'');convertBlock(b,'paragraph');this.render();this.focus(b.id);return;}
+        rewriteBlock(b,head);const kind=['bullet','number','task','quote'].includes(b.kind)?b.kind:'paragraph',next=this.insertAfter(b,kind,text);if(kind==='number'){next.prefix=b.prefix.replace(/\d+/,n=>String(Number(n)+1));rewriteBlock(next,next.text);}this.render();this.focus(next.id);});return;
+    }
+    if(e.key==='Enter'&&b.kind==='code'){e.preventDefault();const r=s.getRangeAt(0);r.deleteContents();const n=document.createTextNode('\n');r.insertNode(n);r.setStartAfter(n);r.collapse(true);s.removeAllRanges();s.addRange(r);this.input({target:el});return;}
+    if(e.key==='Backspace'&&s.isCollapsed&&this.position().offset===0){
+      if(b.kind!=='paragraph'&&b.kind in blockPrefixes){e.preventDefault();this.mutate(()=>{convertBlock(b,'paragraph');this.render();this.focus(b.id);});return;}
+      const index=this.blocks.indexOf(b);let p=index-1;while(this.blocks[p]?.kind==='gap')p--;const prev=this.blocks[p];if(!prev||prev.locked||!['paragraph','bullet','number','task','quote','h1','h2','h3','h4','h5','h6'].includes(prev.kind))return;
+      e.preventDefault();const prevEl=this.root.querySelector(`[data-block="${prev.id}"] [data-editable]`),offset=prevEl?.textContent.length??0;this.mutate(()=>{rewriteBlock(prev,prev.text+b.text);this.blocks.splice(p+1,index-p);this.render();this.focus(prev.id,offset);});
+    }
+    if(e.key==='Tab'&&!mod&&!e.shiftKey&&b.kind==='code'){e.preventDefault();const r=s.getRangeAt(0),n=document.createTextNode('  ');r.deleteContents();r.insertNode(n);r.setStartAfter(n);r.collapse(true);s.removeAllRanges();s.addRange(r);this.input({target:el});}
+  }
+}